日期/时间掩码
日期/时间掩码可用于下列其中一个目的:确定各种函数的输出格式,或指导从值的字符串表示转换为该值的内部格式。
以下是使用日期/时间掩码的两种方法:
- 它确定各种函数的输出格式。例如,在 timetostring 函数中,日期/时间掩码指示字符串输出要使用的格式。如果日期/时间掩码为“hh:tt:ss”,并且时间值为上午 9 点 12 分 24 秒,那么字符串输出为 09:12:24。
- 它将指导从值的字符串表示转换为该值的内部格式。例如,在 stringtotime 函数中,日期/时间掩码指示输入字符串的格式,以便将它正确转换为时间值。如果输入字符串为“05/06/1995”,那么日期/时间掩码“mm/dd/yyyy”指示子串“05”表示月份,而不是表示日。
日期/时间掩码是字符串表达式,其中包含组成部分与可选的分隔符的任何有效组合。因为日期/时间掩码是一个字符串,所以必须用双引号将它引起来。
有关用法示例,请参阅有关日期/时间掩码样本的信息。
组成部分
以下是日期/时间掩码中允许使用的组成部分。在适当的情况下,会列示每个组成部分的有效范围。
组件 | 含义 |
---|---|
dd | 一个月中用两位数表示的日 (1-31)。 |
ddd | 一年中用三位数表示的日 (1-366)。 |
mm | 用一位数或两位数表示的月份 (1-12)。 |
mon | 用三个字母表示的月份缩写 (Jan-Dec)。 |
month | 月份的全名 (January-December)。 |
yy | 用两位数表示的年份 (00-99)。 强烈建议您使用四位数的组成部分 (yyyy) 而不使用两位数的组成部分。使用两位数的组成部分时,在系统内部会将前两位假定为“20”,这有可能不符合您的期望。此外,使用四位数的组成部分将清晰地标识世纪,从而消除任何歧义问题。 |
yyyy | 用四位数表示的年份 (0000-9999)。 |
w | 用一位数表示的星期几(0-6,0 表示星期日,6 表示星期六)。 |
day | 用三个字母表示的日的缩写 (Sat-Sun)。 |
dayname | 日的全名 (Sunday-Saturday)。 |
hh | 一天中的小时数 (0-23)。 |
tt | 一小时中的分钟数 (0-59)。 |
ss | 一分钟中的秒数 (0-59)。 |
am | 指示时间为 am 或 pm(与 24 小时制相对)。 |
xs:datetime | 指示采用 XML 格式的日期和时间,如 W3C XML 模式和 ISO 8601 中所述。格式为: CCYY-MM-DDThh:mm:ss 必须提供所有字段,并且可以选择在前面加上符号和前导数字;如果需要,还可以在后面加上用小数表示的秒以及时区。可以使用字母“Z”(它标识 UTC)来指定时区,或者按照与 UTC 的时间差来指定时区。 |
分隔符
下列符号是有效分隔符。是否使用分隔符是可选的。
分隔符符号 | 分隔符符号 | 分隔符符号 |
---|---|---|
, | . | / |
- | < | > |
? | : | | |
^ | ; | " |
[ | ] | { |
} | _ | = |
@ | % | + |
( | ) | * |
& | # | <空格> |
样本
在所有示例中,时间等价于:
- 2000 年 6 月 8 日,星期三,下午 2 点 05 分 32 秒。
掩码 | 结果 |
---|---|
|
Jun. 8, 2000 |
|
June 8, 2000 |
|
Jun 8, 00 (Wed) |
|
140532 |
|
02:05 pm |
|
8-6-00, 14:05 |
|
6/8/2000, 02:05:032 pm |
|
167, 14:05:32 |
|
05:32 pm |
|
2000-06-08T14:05:32 |