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 」6 月 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 'SetMyCustomFormat

注釈

日付と時刻の区切り記号が含まれているリテラル文字列を表示する、または書式指定文字列、部分文字列のエスケープ文字を使用する必要があります。To display string literals that contain date and time separators or to format strings, you must use escape characters in the substring. たとえば、「6 月 15 日午後 12時 00分」として日付を表示するには、次のように設定します。、CustomFormatプロパティを"'で' t: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"部分文字列がエスケープ文字で囲まれていない場合、結果は"6 月 15日 aP 12時 00分 PM""t"の文字が 1 文字の A.M./P.M として読み取られるためです。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. 2001 年 06 月 15 日として、日付と時刻を表示する例では、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". 詳細については、次を参照してください。 Custom Date and Time Format Stringsします。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 文字の表示します。The one-letter A.M./P.M. (a. m. の省略形abbreviation (A.M. として表示されます"A")。is displayed as "A").
tttt 2 文字の表示します。The two-letter A.M./P.M. (a. m. の省略形abbreviation (A.M. 表示されます"am")。is displayed as "AM").
Yy 1 桁の年 (2001 は「1」と表示されます)。The one-digit year (2001 is displayed as "1").
yyyy (2001 は「01」として表示されます)、年の最後の 2 桁です。The last two digits of the year (2001 is displayed as "01").
yyyyyyyy 年 (2001 は「2001」と表示されます)。The full year (2001 is displayed as "2001").

適用対象

こちらもご覧ください