PowerTools InputMan for ASP.NET 8.0J
Format プロパティ (GcDateTime)
使用例 

入力用の日付時刻書式を示すDateFormatオブジェクトを取得または設定します。
構文
Public Property Format As DateFormat
public DateFormat Format {get; set;}

プロパティ値

既定値:GrapeCity.Web.Input.IMDate.DateFormat("yyy/MM/dd HH:mm:ss")
例外
例外解説
System.ArgumentException 無効な書式が設定されています。
解説
日付時刻コントロールの入力書式は、Formatプロパティが参照するDateFormatオブジェクトを使って設定します。このオブジェクトのDateFormat.Patternプロパティにキーワードとリテラル文字列を設定することで、入力書式を作成します。

DateFormat.Patternプロパティを空の文字列(""またはString.Empty)に設定すると、自由書式入力が可能になります。

日付時刻コントロールの入力書式を設定するDateFormatオブジェクトのPatternプロパティでは、以下のキーワードが使えます。

日付に関するキーワード

キーワード 説明
g 年号の頭文字をアルファベットで表示(M、T、S、H)
gg 年号の頭文字を漢字で表示(明、大、昭、平)
ggg 年号の正式名称を漢字で表示(明治、大正、昭和、平成)
e 和暦年を2桁で表示(先頭に0を付けない)
ee 和暦年を2桁で表示(先頭に0を付ける)
yy 年を2桁で表示(先頭に0を付ける)
yyyy 年を4桁で表示(先頭に0を付ける)
MM 月を2桁の数字で表示(先頭に0を付ける)
MMM 月を省略形で表示
(DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式)
MMMM 月を正式名称で表示
(DateTimeFormatInfo.MonthNames()で指定された形式)
dd 日を2桁で表示(先頭に0を付ける)
\(Chr(92)) キーワードをリテラル文字として表示

元号をキーボードから入力するには、以下のキーを押下します。

元号 明治 大正 昭和 平成
数値入力 1 2 3 4
文字入力 m t s h

キーワード"e"または"ee"を使用する場合は、元号を表すキーワード"g"、"gg"、または"ggg"を必ず併用してください。元号の設定を省くと、日付時刻コントロールは年を特定できず、正常に動作できなくなります。

時刻に関するキーワード

以下の時刻に関するキーワードは、日付コントロール(GcDateクラス)ではサポートされません。

キーワード 説明
t 12時間制で時刻を表示するときに午前(AMDesignatorプロパティで設定)または午後(PMDesignatorプロパティで設定)を表す文字列の最初の1文字を表示
tt 12時間制で時刻を表示するときに午前(AMDesignatorプロパティで設定)または午後(PMDesignatorプロパティで設定)を表す文字列を表示
hh 時を12時間制で表示(先頭に0を付ける)
HH 時を24時間制で表示(先頭に0を付ける)
mm 分を表示(先頭に0を付ける)
ss 秒を表示(先頭に0を付ける)
\(Chr(92)) キーワードをリテラル文字として表示

午前または午後を表す文字列をキーボードから入力するには、以下のキーを押下します。

区分 午前 午後
数値入力 1 2
文字入力 a p

旧式のプロパティ

DateFormatオブジェクトのNullプロパティとEmptyErasプロパティは、8.0J以降で旧式(obsolate)のメンバとなりました。これらのプロパティと同等の機能を実現するには、Watermarkプロパティを使用して、未入力時の表示文字を設定します。

自由書式入力

DateFormatオブジェクトのPatternプロパティに空の文字列(""またはString.Empty)を設定すると、自由書式入力が可能になります。文字列を日付に変換できなかった場合は、コントロールがフォーカスを失ったときにInvalidValueイベントが発生します。

自由書式入力に設定した場合は、次の各プロパティが無効になります。
使用例
最初のサンプルコードは、FormatプロパティとDisplayFormatプロパティを使って日付と時刻の書式を設定する方法を示します。

下のサンプルコードは、同じ設定をDateFormatオブジェクトと DateDisplayFormatオブジェクトを明示的に生成することで行います。
' 日付の書式を設定します。
GcDateTime1.Format.Pattern = "ggg ee年 MM月 dd日"
GcDateTime1.DisplayFormat.Pattern = "ggg ee年 MM月 dd日"

' 時刻の書式を設定します。
GcDateTime1.AMDesignator = "午前"
GcDateTime1.PMDesignator = "午後"
GcDateTime1.Format.Pattern = "tt hh時 mm分"
GcDateTime1.DisplayFormat.Pattern = "tt hh時 mm分"
// 日付の書式を設定します。
GcDateTime1.Format.Pattern = "ggg ee年 MM月 dd日";
GcDateTime1.DisplayFormat.Pattern = "ggg ee年 MM月 dd日";

// 時刻の書式を設定します。
GcDateTime1.AMDesignator = "午前";
GcDateTime1.PMDesignator = "午後";
GcDateTime1.Format.Pattern = "tt hh時 mm分";
GcDateTime1.DisplayFormat.Pattern = "tt hh時 mm分";
Imports GrapeCity.Web.Input.IMDate

' 日付の書式を設定します。
GcDateTime1.Format = New DateFormat("ggg ee年 MM月 dd日")
GcDateTime1.DisplayFormat = New DateDisplayFormat("ggg ee年 MM月 dd日")

' 時刻の書式を設定します。
GcDateTime1.AMDesignator = "午前"
GcDateTime1.PMDesignator = "午後"
GcDateTime1.Format = New DateFormat("tt hh時 mm分")
GcDateTime1.DisplayFormat = New DateDisplayFormat("tt hh時 mm分")
using GrapeCity.Web.Input.IMDate;

// 日付の書式を設定します。
GcDateTime1.Format = new DateFormat("ggg ee年 MM月 dd日");
GcDateTime1.DisplayFormat = new DateDisplayFormat("ggg ee年 MM月 dd日");

// 時刻の書式を設定します。
GcDateTime1.AMDesignator = "午前";
GcDateTime1.PMDesignator = "午後";
GcDateTime1.Format = new DateFormat("tt hh時 mm分");
GcDateTime1.DisplayFormat = new DateDisplayFormat("tt hh時 mm分");
参照

GcDateTime クラス
GcDateTime メンバ
DateFormat クラス
DisplayFormat プロパティ
AMDesignator プロパティ
PMDesignator プロパティ

 

 


© 2005-2015 GrapeCity inc. All rights reserved.