DateTimePicker.CustomFormat 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置自定义日期/时间格式字符串。

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };

public string CustomFormat { get; set; }

public string? CustomFormat { get; set; }

member this.CustomFormat : string with get, set

Public Property CustomFormat As String

属性值

String

表示自定义日期/时间格式的字符串。 默认值为 null。

示例

下面的代码示例设置 CustomFormat 该属性，以便将 DateTimePicker 日期显示为“2001 年 6 月 1 日 - 星期五”。 此代码假定已在某个控件上创建一个Form实例DateTimePicker。

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

注解

若要显示包含日期和时间分隔符或设置字符串格式的字符串文本，必须在子字符串中使用转义字符。 例如，若要将日期显示为“6 月 15 日下午 12：00”，请将 CustomFormat 属性设置为“MMMM dd 'at' t：mm tt”。 如果“at”子字符串未由转义字符括起来，则结果为“6 月 15 日 aP 12：00PM”，因为“t”字符读取为单字母 A.M./P.M. M。 格式字符串 (请参阅以下格式字符串表) 。

格式字符串可以组合在一起，以设置日期和时间的格式。 例如，若要将日期和时间显示为 2001/06/15 下午 12：00，此属性应设置为“MM'/'dd'/'yy hh'：'mm tt”。 有关详细信息，请参阅 自定义日期和时间格式字符串。

备注

Format此属性必须设置为DateTimePickerFormat.Custom此属性，以影响所显示日期和时间的格式。

下表列出了所有有效的格式字符串及其说明。

格式字符串	说明
d	一位数或两位数的一天。
dd	两位数的日期。 单位数日值前面有 0。
ddd	为期三个字符的星期几缩写。
dddd	整整一周的名称。
h	采用 12 小时格式的一位数或两位数小时。
hh	采用 12 小时格式的两位数小时。 0 前面有一个数字值。
H	采用 24 小时格式的一到两位数小时。
HH	采用 24 小时格式的两位数小时。 0 前面有一个数字值。
m	一位数或两位数分钟。
MM	两位数分钟。 0 前面有一个数字值。
M	一位数或两位数的月份数。
MM	两位数的月份数。 0 前面有一个数字值。
MMM	三个字符的月份缩写。
MMMM	完整月份名称。
s	一位数或两位数秒。
ss	两位数秒。 0 前面有一个数字值。
T	单字母 A.M./P.M. 缩写 (A.M. 显示为“A”) 。
tt	双字母 A.M./P.M. 缩写 (A.M. 显示为“AM”) 。
y	2001 年一位数 (的年份显示为“1”) 。
yy	2001 年 (年度的最后两位数字显示为“01”) 。
yyyy	2001年全年 (显示为“2001”) 。

另请参阅

• DateTimePickerFormat
• Format