更新时间:2022-07-29 GMT+08:00

时间、日期处理函数和操作符

时间日期操作符

用户在使用时间和日期操作符时,对应的操作数请使用明确的类型前缀修饰,以确保数据库在解析操作数的时候能够与用户预期一致,不会产生用户非预期的结果。

比如下面示例没有明确数据类型就会出现异常错误。

1
SELECT date '2001-10-01' - '7' AS RESULT;
表1 时间和日期操作符

操作符

示例

+

1
2
3
4
5
SELECT date '2001-09-28' + integer '7' AS RESULT;
       result        
---------------------
 2001-10-05 00:00:00
(1 row)
1
2
3
4
5
SELECT date '2001-09-28' + interval '1 hour' AS RESULT;
       result        
---------------------
 2001-09-28 01:00:00
(1 row)
1
2
3
4
5
SELECT date '2001-09-28' + time '03:00' AS RESULT;
       result        
---------------------
 2001-09-28 03:00:00
(1 row)
1
2
3
4
5
SELECT interval '1 day' + interval '1 hour' AS RESULT;
     result     
----------------
 1 day 01:00:00
(1 row)
1
2
3
4
5
SELECT timestamp '2001-09-28 01:00' + interval '23 hours' AS RESULT;
       result        
---------------------
 2001-09-29 00:00:00
(1 row)
1
2
3
4
5
SELECT time '01:00' + interval '3 hours' AS RESULT;
  result  
----------
 04:00:00
(1 row)

-

1
2
3
4
5
SELECT date '2001-10-01' - date '2001-09-28' AS RESULT;
 result 
--------
 3 days
(1 row)
1
2
3
4
5
SELECT date '2001-10-01' - integer '7' AS RESULT;
       result        
---------------------
 2001-09-24 00:00:00
(1 row)
1
2
3
4
5
SELECT date '2001-09-28' - interval '1 hour' AS RESULT;
       result        
---------------------
 2001-09-27 23:00:00
(1 row)
1
2
3
4
5
SELECT time '05:00' - time '03:00' AS RESULT;
  result  
----------
 02:00:00
(1 row)
1
2
3
4
5
SELECT time '05:00' - interval '2 hours' AS RESULT;
  result  
----------
 03:00:00
(1 row)
1
2
3
4
5
SELECT timestamp '2001-09-28 23:00' - interval '23 hours' AS RESULT;
       result        
---------------------
 2001-09-28 00:00:00
(1 row)
1
2
3
4
5
SELECT interval '1 day' - interval '1 hour' AS RESULT;
  result  
----------
 23:00:00
(1 row)
1
2
3
4
5
SELECT timestamp '2001-09-29 03:00' - timestamp '2001-09-27 12:00' AS RESULT;
     result     
----------------
 1 day 15:00:00
(1 row)

*

1
2
3
4
5
SELECT 900 * interval '1 second' AS RESULT;
  result  
----------
 00:15:00
(1 row)
1
2
3
4
5
SELECT 21 * interval '1 day' AS RESULT;
 result  
---------
 21 days
(1 row)
1
2
3
4
5
SELECT double precision '3.5' * interval '1 hour' AS RESULT;
  result  
----------
 03:30:00
(1 row)

/

1
2
3
4
5
SELECT interval '1 hour' / double precision '1.5' AS RESULT;
  result  
----------
 00:40:00
(1 row)

时间/日期函数

  • age(timestamp, timestamp)

    描述:将两个参数相减,并以年、月、日作为返回值。若相减值为负,则函数返回亦为负。

    返回值类型:interval

    示例:

    1
    2
    3
    4
    5
    SELECT age(timestamp '2001-04-10', timestamp '1957-06-13');
               age           
    -------------------------
     43 years 9 mons 27 days
    (1 row)
    
  • age(timestamp)

    描述:当前时间和参数相减。

    返回值类型:interval

    示例:

    1
    2
    3
    4
    5
    SELECT age(timestamp '1957-06-13');
               age           
    -------------------------
     60 years 2 mons 18 days
    (1 row)
    
  • timestampdiff(field, timestamp1, timestamp2)

    描述:将两个日期参数相减(timestamp2 - timestamp1),并以单位field作为返回值。若相减值为负,则函数返回值为负。field支持的参数为day、month、quarter、day、week、hour、minute、second和microsecond。

    返回值类型:bigint

    示例:

    SELECT timestampdiff(day, timestamp '2001-02-01', timestamp '2003-05-01 12:05:55');
     timestampdiff 
    ---------------
          819
    (1 row)
  • clock_timestamp()

    描述:实时时钟的当前时间戳。

    返回值类型:timestamp with time zone

    示例:

    1
    2
    3
    4
    5
    SELECT clock_timestamp();
            clock_timestamp        
    -------------------------------
     2017-09-01 16:57:36.636205+08
    (1 row)
    
  • current_date

    描述:当前日期。

    返回值类型:date

    示例:

    1
    2
    3
    4
    5
    SELECT current_date;
        date    
    ------------
     2017-09-01
    (1 row)
    
  • current_time

    描述:当前时间。

    返回值类型:time with time zone

    示例:

    1
    2
    3
    4
    5
    SELECT current_time;
           timetz       
    --------------------
     16:58:07.086215+08
    (1 row)
    
  • current_timestamp

    描述:当前日期及时间。

    返回值类型:timestamp with time zone

    示例:

    1
    2
    3
    4
    5
    SELECT current_timestamp;
           pg_systimestamp        
    ------------------------------
     2017-09-01 16:58:19.22173+08
    (1 row)
    
  • date_part(text, timestamp)

    描述:

    获取小时的值。

    等效于extract(field from timestamp)。

    返回值类型:double precision

    示例:

    1
    2
    3
    4
    5
    SELECT date_part('hour', timestamp '2001-02-16 20:38:40');
     date_part 
    -----------
            20
    (1 row)
    
  • date_part(text, interval)

    描述:

    获取月份的值。如果大于12,则取与12的模。

    等效于extract(field from timestamp)。

    返回值类型:double precision

    示例:

    1
    2
    3
    4
    5
    SELECT date_part('month', interval '2 years 3 months');
     date_part 
    -----------
             3
    (1 row)
    
  • date_trunc(text, timestamp)

    描述:截取到参数text指定的精度。

    返回值类型:timestamp

    示例:

    1
    2
    3
    4
    5
    SELECT date_trunc('hour', timestamp  '2001-02-16 20:38:40');
         date_trunc      
    ---------------------
     2001-02-16 20:00:00
    (1 row)
    
  • trunc(timestamp)

    描述:默认按天截取。

    示例:

    1
    2
    3
    4
    SELECT trunc(timestamp  '2001-02-16 20:38:40');                                                                                                                                                                   trunc
    ---------------------
    2001-02-16 00:00:00
    (1 row)
    
  • extract(field from timestamp)

    描述:获取小时的值。

    返回值类型:double precision

    示例:

    1
    2
    3
    4
    5
    SELECT extract(hour from timestamp '2001-02-16 20:38:40');
     date_part 
    -----------
            20
    (1 row)
    
  • extract(field from interval)

    描述:获取月份的值。如果大于12,则取与12的模。

    返回值类型:double precision

    示例:

    1
    2
    3
    4
    5
    SELECT extract(month from interval '2 years 3 months');
     date_part 
    -----------
             3
    (1 row)
    
  • isfinite(date)

    描述:测试是否为有效日期。

    返回值类型:boolean

    示例:

    1
    2
    3
    4
    5
    SELECT isfinite(date '2001-02-16');
     isfinite 
    ----------
     t
    (1 row)
    
  • isfinite(timestamp)

    描述:测试判断是否为有效时间。

    返回值类型:boolean

    示例:

    1
    2
    3
    4
    5
    SELECT isfinite(timestamp '2001-02-16 21:28:30');
     isfinite 
    ----------
     t
    (1 row)
    
  • isfinite(interval)

    描述:测试是否为有效区间。

    返回值类型:boolean

    示例:

    1
    2
    3
    4
    5
    SELECT isfinite(interval '4 hours');
     isfinite 
    ----------
     t
    (1 row)
    
  • justify_days(interval)

    描述:将时间间隔以30天为单位,表示为月。

    返回值类型:interval

    示例:

    1
    2
    3
    4
    5
    SELECT justify_days(interval '35 days');
     justify_days 
    --------------
     1 mon 5 days
    (1 row)
    
  • justify_hours(interval)

    描述:将时间间隔以24小时为单位,表示为天。

    返回值类型:interval

    示例:

    1
    2
    3
    4
    5
    SELECT JUSTIFY_HOURS(INTERVAL '27 HOURS');
     justify_hours  
    ----------------
     1 day 03:00:00
    (1 row)
    
  • justify_interval(interval)

    描述:结合justify_days和justify_hours,调整interval。

    返回值类型:interval

    示例:

    1
    2
    3
    4
    5
    SELECT JUSTIFY_INTERVAL(INTERVAL '1 MON -1 HOUR');
     justify_interval 
    ------------------
     29 days 23:00:00
    (1 row)
    
  • localtime

    描述:当前时间。

    返回值类型:time

    示例:

    1
    2
    3
    4
    5
    SELECT localtime AS RESULT;
         result
    ----------------
     16:05:55.664681
    (1 row)
    
  • localtimestamp

    描述:当前日期及时间。

    返回值类型:timestamp

    示例:

    1
    2
    3
    4
    5
    SELECT localtimestamp;
             timestamp          
    ----------------------------
     2017-09-01 17:03:30.781902
    (1 row)
    
  • now()

    描述:当前事务开始的时间戳。

    返回值类型:timestamp with time zone

    示例:

    1
    2
    3
    4
    5
    SELECT now();
                  now              
    -------------------------------
     2017-09-01 17:03:42.549426+08
    (1 row)
    
  • numtodsinterval(num, interval_unit)

    描述:将数字转换为interval类型。num为numeric类型数字,interval_unit为固定格式字符串('DAY' | 'HOUR' | 'MINUTE' | 'SECOND')。

    可以通过设置参数IntervalStyle为oracle,兼容该函数在Oracle中的interval输出格式。

    示例:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    SELECT numtodsinterval(100, 'HOUR');
     numtodsinterval 
    -----------------
     100:00:00
    (1 row)
    
    SET intervalstyle = oracle;
    SET
    SELECT numtodsinterval(100, 'HOUR');
            numtodsinterval
    -------------------------------
     +000000004 04:00:00.000000000
    (1 row)
    
  • pg_sleep(seconds)

    描述:是服务器线程延迟时间,以秒记。

    返回值类型:void

    示例:

    1
    2
    3
    4
    5
    SELECT pg_sleep(10);
     pg_sleep 
    ----------
    
    (1 row)
    
  • statement_timestamp()

    描述:当前日期及时间。

    返回值类型:timestamp with time zone

    示例:

    1
    2
    3
    4
    5
    SELECT statement_timestamp();
          statement_timestamp      
    -------------------------------
     2017-09-01 17:04:39.119267+08
    (1 row)
    
  • sysdate

    描述:当前日期及时间。

    返回值类型:timestamp

    示例:

    1
    2
    3
    4
    5
    SELECT sysdate;
           sysdate       
    ---------------------
     2017-09-01 17:04:49
    (1 row)
    
  • timeofday()

    描述:当前日期及时间(像clock_timestamp,但是返回时为text。)

    返回值类型:text

    示例:

    1
    2
    3
    4
    5
    SELECT timeofday();
                  timeofday              
    -------------------------------------
     Fri Sep 01 17:05:01.167506 2017 CST
    (1 row)
    
  • transaction_timestamp()

    描述:当前日期及时间,与current_timestamp等效。

    返回值类型:timestamp with time zone

    示例:

    1
    2
    3
    4
    5
    SELECT transaction_timestamp();
         transaction_timestamp     
    -------------------------------
     2017-09-01 17:05:13.534454+08
    (1 row)
    
  • add_months(d,n)

    描述:用于计算时间点d再加上n个月的时间。

    返回值类型:timestamp

    示例:

    1
    2
    3
    4
    5
    SELECT add_months(to_date('2017-5-29', 'yyyy-mm-dd'), 11) FROM dual;
         add_months      
    ---------------------
     2018-04-29 00:00:00
    (1 row)
    
  • last_day(d)

    描述:用于计算时间点d本月最后一天的时间。

    • ORA和TD兼容模式下,返回值类型为timestamp。
    • MySQL兼容模式下,返回值类型为date。

    示例:

    1
    2
    3
    4
    5
    select last_day(to_date('2017-01-01', 'YYYY-MM-DD')) AS cal_result;
         cal_result      
    ---------------------
     2017-01-31 00:00:00
    (1 row)
    
  • next_day(x,y)

    描述:用于计算x时间开始的下一个星期y的时间。

    • ORA和TD兼容模式下,返回值类型为timestamp。
    • MySQL兼容模式下,返回值类型为date。

    示例:

    1
    2
    3
    4
    5
    select next_day(timestamp '2017-05-25 00:00:00','Sunday')AS cal_result;
         cal_result      
    ---------------------
     2017-05-28 00:00:00
    (1 row)
    
  • to_days(timestamp)

    描述:返回自0年开始到入参日期的天数。

    返回值类型:int

    示例:

    1
    2
    3
    4
    5
    SELECT to_days(timestamp '2008-10-07');
     to_days
    ---------
      733687
    (1 row)
    

EXTRACT

EXTRACT(field FROM source)

extract函数从日期或时间的数值里抽取子域,比如年、小时等。source必须是一个timestamp、time或interval类型的值表达式(类型为date的表达式转换为timestamp,因此也可以用)。field是一个标识符或者字符串,它指定从源数据中抽取的域。extract函数返回类型为double precision的数值。field的取值范围如下所示。

  • century

    世纪。

    第一个世纪从0001-01-01 00:00:00 AD开始。这个定义适用于所有使用阳历的国家。没有0世纪,直接从公元前1世纪到公元1世纪。

    示例:

    1
    2
    3
    4
    5
    SELECT EXTRACT(CENTURY FROM TIMESTAMP '2000-12-16 12:21:13');
     date_part 
    -----------
            20
    (1 row)
    
  • day
    • 如果source为timestamp,表示月份里的日期(1-31)。
      1
      2
      3
      4
      5
      SELECT EXTRACT(DAY FROM TIMESTAMP '2001-02-16 20:38:40');
       date_part 
      -----------
              16
      (1 row)
      
    • 如果source为interval,表示天数。
      1
      2
      3
      4
      5
      SELECT EXTRACT(DAY FROM INTERVAL '40 days 1 minute');
       date_part 
      -----------
              40
      (1 row)
      
  • decade

    年份除以10。

    1
    2
    3
    4
    5
    SELECT EXTRACT(DECADE FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
           200
    (1 row)
    
  • dow

    每周的星期几,星期天(0)到星期六(6)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(DOW FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
             5
    (1 row)
    
  • doy

    一年的第几天(1~365/366)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(DOY FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
            47
    (1 row)
    
  • epoch
    • 如果source为timestamp with time zone,表示自1970-01-01 00:00:00-00 UTC以来的秒数(结果可能是负数);

      如果source为date和timestamp,表示自1970-01-01 00:00:00-00当地时间以来的秒数;

      如果source为interval,表示时间间隔的总秒数。

      1
      2
      3
      4
      5
      SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08');
        date_part   
      --------------
       982384720.12
      (1 row)
      
      1
      2
      3
      4
      5
      SELECT EXTRACT(EPOCH FROM INTERVAL '5 days 3 hours');
       date_part 
      -----------
          442800
      (1 row)
      
    • 将epoch值转换为时间戳的方法。
      1
      2
      3
      4
      5
      SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * INTERVAL '1 second' AS RESULT;
                result          
      ---------------------------
       2001-02-17 12:38:40.12+08
      (1 row)
      
  • hour

    小时域(0-23)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(HOUR FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
            20
    (1 row)
    
  • isodow

    一周的第几天(1-7)。

    星期一为1,星期天为7。

    除了星期天外,都与dow相同。

    1
    2
    3
    4
    5
    SELECT EXTRACT(ISODOW FROM TIMESTAMP '2001-02-18 20:38:40');
     date_part 
    -----------
             7
    (1 row)
    
  • isoyear

    日期中的ISO 8601标准年(不适用于间隔)。

    每个带有星期一开始的周中包含1月4日的ISO年,所以在年初的1月或12月下旬的ISO年可能会不同于阳历的年。详细信息请参见后续的week描述。

    1
    2
    3
    4
    5
    SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-01');
     date_part 
    -----------
          2005
    (1 row)
    
    1
    2
    3
    4
    5
    SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02');
     date_part 
    -----------
          2006
    (1 row)
    
  • microseconds

    秒域(包括小数部分)乘以1,000,000。

    1
    2
    3
    4
    5
    SELECT EXTRACT(MICROSECONDS FROM TIME '17:12:28.5');
     date_part 
    -----------
      28500000
    (1 row)
    
  • millennium

    千年。

    20世纪(19xx年)里面的年份在第二个千年里。第三个千年从2001年1月1日零时开始。

    1
    2
    3
    4
    5
    SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
             3
    (1 row)
    
  • milliseconds

    秒域(包括小数部分)乘以1000。请注意它包括完整的秒。

    1
    2
    3
    4
    5
    SELECT EXTRACT(MILLISECONDS FROM TIME '17:12:28.5');
     date_part 
    -----------
         28500
    (1 row)
    
  • minute

    分钟域(0-59)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(MINUTE FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
            38
    (1 row)
    
  • month

    如果source为timestamp,表示一年里的月份数(1-12)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(MONTH FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
             2
    (1 row)
    

    如果source为interval,表示月的数目,然后对12取模(0-11)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(MONTH FROM INTERVAL '2 years 13 months');
     date_part 
    -----------
             1
    (1 row)
    
  • quarter

    该天所在的该年的季度(1-4)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(QUARTER FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
             1
    (1 row)
    
  • second

    秒域,包括小数部分(0-59)。

    1
    2
    3
    4
    5
    SELECT EXTRACT(SECOND FROM TIME '17:12:28.5');
     date_part 
    -----------
          28.5
    (1 row)
    
  • timezone

    与UTC的时区偏移量,单位为秒。正数对应UTC东边的时区,负数对应UTC西边的时区。

  • timezone_hour

    时区偏移量的小时部分。

  • timezone_minute

    时区偏移量的分钟部分。

  • week

    该天在所在的年份里是第几周。ISO 8601定义一年的第一周包含该年的一月四日(ISO-8601 的周从星期一开始)。换句话说,一年的第一个星期四在第一周。

    在ISO定义里,一月的头几天可能是前一年的第52或者第53周,十二月的后几天可能是下一年第一周。比如,2005-01-01是2004年的第53周,而2006-01-01是2005年的第52周,2012-12-31是2013年的第一周。建议isoyear字段和week一起使用以得到一致的结果。

    1
    2
    3
    4
    5
    SELECT EXTRACT(WEEK FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
             7
    (1 row)
    
  • year

    年份域。

    1
    2
    3
    4
    5
    SELECT EXTRACT(YEAR FROM TIMESTAMP '2001-02-16 20:38:40');
     date_part 
    -----------
          2001
    (1 row)
    

date_part

date_part函数是在传统的Ingres函数的基础上制作的(该函数等效于SQL标准函数extract):

date_part('field', source)

这里的field参数必须是一个字符串,而不是一个名字。有效的field与extract一样,详细信息请参见EXTRACT

示例:

1
2
3
4
5
SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40');
 date_part 
-----------
        16
(1 row)
1
2
3
4
5
SELECT date_part('hour', INTERVAL '4 hours 3 minutes');
 date_part 
-----------
         4
(1 row)

表2显示了可以用于格式化日期和时间值的模版,这些模式适用于函数to_date、to_timestamp、to_char和参数nls_timestamp_format。

表2 用于日期/时间格式化的模式

类别

模式

描述

小时

HH

一天的小时数(01-12)

HH12

一天的小时数(01-12)

HH24

一天的小时数(00-23)

分钟

MI

分钟(00-59)

SS

秒(00-59)

FF

微秒(000000-999999)

SSSSS

午夜后的秒(0-86399)

上、下午

AM或A.M.

上午标识

PM或P.M.

下午标识

Y,YYY

带逗号的年(4和更多位)

SYYYY

公元前四位年

YYYY

年(4和更多位)

YYY

年的后三位

YY

年的后两位

Y

年的最后一位

IYYY

ISO年(4位或更多位)

IYY

ISO年的最后三位

IY

ISO年的最后两位

I

ISO年的最后一位

RR

年的后两位(可在21世纪存储20世纪的年份)

RRRR

可接收4位年或两位年。若是两位,则和RR的返回值相同,若是四位,则和YYYY相同。

  • BC或B.C.
  • AD或A.D.

纪元标识。BC(公元前),AD(公元后)。

MONTH

全长大写月份名(空白填充为9字符)

MON

大写缩写月份名(3字符)

MM

月份数(01-12)

RM

罗马数字的月份(I-XII ;I=JAN)(大写)

DAY

全长大写日期名(空白填充为9字符)

DY

缩写大写日期名(3字符)

DDD

一年里的日(001-366)

DD

一个月里的日(01-31)

D

一周里的日(1-7 ;周日是 1)

W

一个月里的周数(1-5)(第一周从该月第一天开始)

WW

一年里的周数(1-53)(第一周从该年的第一天开始)

IW

ISO一年里的周数(第一个星期四在第一周里)

世纪

CC

世纪(2位)(21 世纪从 2001-01-01 开始)

儒略日

J

儒略日(自公元前 4712 年 1 月 1 日来的天数)

季度

Q

季度

上表中RR计算年的规则如下:

  • 输入的两位年份在00~49之间:

    当前年份的后两位在00~49之间,返回值年份的前两位和当前年份的前两位相同;

    当前年份的后两位在50~99之间,返回值年份的前两位是当前年份的前两位加1。

  • 输入的两位年份在50~99之间:

    当前年份的后两位在00~49之间,返回值年份的前两位是当前年份的前两位减1;

    当前年份的后两位在50~99之间,返回值年份的前两位和当前年份的前两位相同。

date_format

date_format(timestamp, fmt)

date_format函数将日期参数按照fmt指定的格式转换为字符串。

示例:

SELECT date_format('2009-10-04 22:23:00', '%M %D %W');
    date_format
--------------------
 October 4th Sunday
(1 row)
SELECT date_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S');
     date_format
---------------------
 2021-02-20 08:30:45
(1 row)
SELECT date_format('2021-02-20 18:10:15', '%r-%T');
     date_format
----------------------
 06:10:15 PM-18:10:15
(1 row)

表 date_format支持的输出格式显示了可以用于将日期参数格式化输出的格式类型,这些格式类型适用于函数date_format、time_format、str_to_date、str_to_time和from_unixtime。

表3 date_format支持的输出格式

格式

说明

取值

%a

缩写星期名

Sun...Sat

%b

缩写月份名

Jan...Dec

%c

月份

0...12

%D

带英文后缀的月份日期

0th, 1st, 2nd, 3rd, …

%d

一个月里的日,2位

00...31

%e

一个月里的日

0...31

%f

微秒

000000...999999

%H

小时,24小时制

00...23

%h

小时,12小时制

01...12

%I

小时,12小时制,同%h

01...12

%i

分钟

00...59

%j

一年里的日

001...366

%k

小时,24小时制,同%H

0...23

%l

小时,12小时制,同%h

1...12

%M

月份名

January...December

%m

月份,两位

00...12

%p

上下午

AM PM

%r

时间,12小时制

hh::mm::ss AM/PM

%S

00...59

%s

秒,同%S

00...59

%T

时间,24小时制

hh::mm::ss

%U

周 (00-53) 星期日是一周的第一天

00...53

%u

周 (00-53) 星期一是一周的第一天

00...53

%V

周 (01-53) 星期日是一周的第一天,与%X搭配使用

01...53

%v

周 (01-53) 星期一是一周的第一天,与%x搭配使用

01...53

%W

星期名

Sunday...Saturday

%w

一周的日,周日为0

0...6

%X

年份,其中的星期日是周的第一天,4 位,与%V搭配使用

-

%x

年份,其中的星期一是周的第一天,4 位,与%v搭配使用

-

%Y

年份,4位

-

%y

年份,2位

-

%%

字符'%'

字符'%'

%x

'x',上述未列出的任意字符

字符'x'

date_format支持的输出格式中,%U、%u、%V、%v、%X、%x暂不支持。