DateTimePicker.CustomFormat DateTimePicker.CustomFormat DateTimePicker.CustomFormat DateTimePicker.CustomFormat Property

定義

日付/時刻のカスタム書式指定文字列を取得または設定します。Gets or sets the custom date/time format string.

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };
public string CustomFormat { get; set; }
member this.CustomFormat : string with get, set
Public Property CustomFormat As String

プロパティ値

カスタムの日付/時刻書式を表す文字列。A string that represents the custom date/time format. 既定値は、null です。The default is null.

次のコード例ではCustomFormat 、でDateTimePicker日付が "June 01, 2001-金曜" と表示されるようにプロパティを設定しています。The following code example sets the CustomFormat property so that the DateTimePicker will display the date as "June 01, 2001 - Friday". このコードでは、 DateTimePicker Formコントロールのインスタンスがに作成されていることを前提としています。This code assumes that an instance of a DateTimePicker control has been created on a Form.

public:
   void SetMyCustomFormat()
   {
      // Set the Format type and the CustomFormat string.
      dateTimePicker1->Format = DateTimePickerFormat::Custom;
      dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
   }
public void SetMyCustomFormat()
{
   // Set the Format type and the CustomFormat string.
   dateTimePicker1.Format = DateTimePickerFormat.Custom;
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
}

Public Sub SetMyCustomFormat()
    ' Set the Format type and the CustomFormat string.
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub

注釈

日付と時刻の区切り記号を含む文字列リテラルを表示するか、文字列の書式を設定するには、部分文字列でエスケープ文字を使用する必要があります。To display string literals that contain date and time separators or to format strings, you must use escape characters in the substring. たとえば、日付を "June 15 at 12:00 PM" として表示するにはCustomFormat 、プロパティを ' \ mm tt ' の "MMMM dd" に設定します。For example, to display the date as "June 15 at 12:00 PM", set the CustomFormat property to "MMMM dd 'at' t:mm tt". "At" 部分文字列がエスケープ文字で囲まれていない場合、"t" 文字は午前1時/P.M. 表示として読み取られるので、結果は "June 15 aP 12: 00PM" になります。If the "at" substring is not enclosed by escape characters, the result is "June 15 aP 12:00PM" because the "t" character is read as the one-letter A.M./P.M. 書式設定文字列 (下の「書式指定文字列」の表を参照)。format string (see the format string table below).

書式指定文字列は、日付と時刻を書式設定するために組み合わせることができます。The format strings can be combined to format the date and time. たとえば、日付と時刻を 06/15/2001 12:00 PM として表示するには、このプロパティを "MM"/' dd '/' yyyy hh ': ' mm tt ' に設定する必要があります。For example, to display the date and time as 06/15/2001 12:00 PM, this property should be set to "MM'/'dd'/'yyyy hh':'mm tt". 詳細については、「カスタム日時書式指定文字列」を参照してください。For more information, see Custom Date and Time Format Strings.

注意

このFormatプロパティが表示されDateTimePickerFormat.Customている日付と時刻の書式設定に影響を与えるようにするには、プロパティをに設定する必要があります。The Format property must be set to DateTimePickerFormat.Custom for this property to affect the formatting of the displayed date and time.

次の表に、すべての有効な書式指定文字列とその説明を示します。The following table lists all the valid format strings and their descriptions.

書式文字列Format string 説明Description
dd 1桁または2桁の日。The one- or two-digit day.
dddd 2桁の数字。The two-digit day. 1桁の日付の値の前に0が付きます。Single-digit day values are preceded by a 0.
dddddd 3文字の曜日の省略形。The three-character day-of-week abbreviation.
dddddddd 曜日の完全な名前。The full day-of-week name.
hh 12時間形式の1桁または2桁の時刻。The one- or two-digit hour in 12-hour format.
hhhh 12時間形式の2桁の時刻。The two-digit hour in 12-hour format. 1桁の値の前には0が付きます。Single digit values are preceded by a 0.
HH 24時間形式の1桁または2桁の時刻。The one- or two-digit hour in 24-hour format.
HHHH 24時間形式の2桁の時刻。The two-digit hour in 24-hour format. 1桁の値の前には0が付きます。Single digit values are preceded by a 0.
mm 1桁または2桁の分。The one- or two-digit minute.
mmmm 2桁の分。The two-digit minute. 1桁の値の前には0が付きます。Single digit values are preceded by a 0.
MM 1桁または2桁の月の数値。The one- or two-digit month number.
MMMM 2桁の月の数値。The two-digit month number. 1桁の値の前には0が付きます。Single digit values are preceded by a 0.
MMMMM 3桁の月の省略形。The three-character month abbreviation.
MMMMMMMM 月の完全な名前。The full month name.
ss 1桁または2桁の秒。The one- or two-digit seconds.
ssss 2桁の秒。The two-digit seconds. 1桁の値の前には0が付きます。Single digit values are preceded by a 0.
tt 1文字の午前の/P.M. 表示The one-letter A.M./P.M. 略称 (午前abbreviation (A.M. は "A" と表示されます)。is displayed as "A").
tttt 2文字の午前の/P.M. 表示The two-letter A.M./P.M. 略称 (午前abbreviation (A.M. は "AM" と表示されます)。is displayed as "AM").
Yy 1桁の年 (2001 は "1" と表示されます)。The one-digit year (2001 is displayed as "1").
yyyy 年の最後の2桁 (2001 は "01" と表示されます)。The last two digits of the year (2001 is displayed as "01").
yyyyyyyy 完全な年 (2001 は "2001" と表示されます)。The full year (2001 is displayed as "2001").

適用対象

こちらもご覧ください