日、月、年和纪元格式图片

应用程序使用本主题中所述的元素来构造以 null 结尾的格式图片字符串。 如果使用空格分隔字符串中的元素,则这些空格将显示在输出字符串中的同一位置。

注意

格式类型“d”、“g”和“y”必须为小写,字母“M”必须为大写。

 

例如,若要获取日期字符串“Wed, Aug 31 94”,应用程序使用图片字符串“ddd','MMM dd yy”。

应用程序使用单引号将字符标记为完全按指定显示。 如果应用程序必须显示单引号,则应在一行中放置两个单引号。 例如,'abc''bar'显示为“abc'bar”。

下表定义了用于表示天数的格式类型。

格式类型 含义
d 表示为数字的月份日期,对于一位数日期不使用前导零。
dd 表示为数字的月份日期,对于一位数日期使用前导零。
ddd LOCALE_SABBREVDAYNAME* 值指定的星期几,例如英语 (美国) 中的“Mon”。Windows Vista 及更高版本:如果需要星期几的短版本,应用程序应使用 LOCALE_SSHORTESTDAYNAME* 常量。
dddd LOCALE_SDAYNAME* 值指定的星期几。

 

下表定义了用于表示月份的格式类型。

格式类型 含义
M 表示为数字的月份,对于一位数月份不使用前导零。
MM 表示为数字的月份,对于一位数月份使用前导零。
MMM LOCALE_SABBREVMONTHNAME* 值指定的缩写月份,例如英语 (美国) 中的“Nov”。
MMMM LOCALE_SMONTHNAME* 值指定的月份,例如,“November”表示英语 (美国) ,“Noviembre”表示西班牙语 (西班牙) 。

 

下表定义了用于表示年份的格式类型。

格式类型 含义
y 仅由最后一位数字表示的年份。
yy 仅由最后两位数字表示的年份。 会为一位数年份添加前导零。
yyyy 由完整的四位或五位数字表示的年份,具体取决于所使用的日历。 泰国佛教和朝鲜历有五位数的年份。 “yyyy”模式显示这两个日历的五位数,其他所有支持的日历显示四位数字。 具有个位数或两位数年份的日历(例如日本天皇时代)的表示方式不同。 一位数年份表示为前导零,例如“03”。 两位数年份用两位数字表示,例如“13”。 不显示其他前导零。
yyyyy 行为与“yyyy”相同。

 

下表定义了用于表示句点或纪元的格式类型。

格式类型 含义
g、gg 按CAL_SERASTRING值指定的格式设置的时间段/纪元字符串。 如果没有关联的纪元或周期字符串,则忽略日期字符串中的“g”和“gg”格式图片。