使用英语阅读

通过

DateTimePicker.CustomFormat 属性

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

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

C# 
public string CustomFormat { get; set; }
C# 
public string? CustomFormat { get; set; }

属性值

String

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

示例

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

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

注解

若要显示包含日期和时间分隔符或设置字符串格式的字符串文本，必须在子字符串中使用转义字符。 例如，若要将日期显示为“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”) 。

适用于

产品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

另请参阅