wcsftime

wcsftime

根据格式字符串将日期和时间信息从给定的日历时间转换time为以空字符结尾的宽str字符串format。最多count写入字节。

参数

| 年份|

| Y | 将年份写为十进制数字，例如2017 | tm_year |

| EY（C99）| 在替代表示中写入年份，例如平成23年（平成23年）而不是2011年（2011年）在ja_JP地区| tm_year |

| y | 将年份的最后2位数字写为十进制数（范围为00,99）| tm_year |

| Oy（C99）| 使用替代数字系统写入年份的最后2位数字，例如ja_JP locale |中的十一而不是11 tm_year |

| Ey（C99）| 将年份写入与区域设置的替代日历期％EC（区域依赖）|的偏移量 tm_year |

| C（C99）| 写一年的前两位数作为十进制数（范围为00,99）| tm_year |

| EC（C99）| 在地区的替代表示中写入基准年（期间）的名称，例如平成（平成时代）in ja_JP | tm_year |

| G（C99）| 写ISO 8601以周为基础的年份，即包含指定周的年份。在IS0 8601周内从星期一开始，并且一年中的第一周必须满足以下要求：包括1月4日包括今年的第一个星期四| tm_year，tm_wday，tm_yday |

| g（C99）| 写出ISO 8601以周为单位的年份的最后2位数字，即包含指定周的年份（范围00,99）。在IS0 8601周内从星期一开始，并且一年中的第一周必须满足以下要求：包括1月4日包括今年的第一个星期四| tm_year，tm_wday，tm_yday |

| 月|

| b | 写出缩写的月份名称，例如Oct（区域依赖）| tm_mon |

| h（C99）| b |的同义词 tm_mon |

| B | 写完整的月份名称，例如10月（取决于语言环境）| tm_mon |

| m | 将月份作为十进制数字（范围为01,12）|写入 tm_mon |

| Om（C99）| 使用替代数字系统写月份，例如ja_JP locale |中的十二而不是12 tm_mon |

| 星期|

| U | 写一年中的一周作为十进制数（星期日是一周中的第一天）（范围00,53）| tm_year，tm_wday，tm_yday |

| OU（C99）| 写一年中的一周，如％U，使用替代数字系统，例如五十二而不是ja_JP语言环境中的52。tm_year，tm_wday，tm_yday |

| W | 写一年中的一周作为十进制数（星期一是一周中的第一天）（范围00,53）| tm_year，tm_wday，tm_yday |

| OW（C99）| 用％W写出一年中的第一周，使用替代数字系统，例如ja_JP语言环境中的五十二而不是52。tm_year，tm_wday，tm_yday |

| V（C99）| 写一年的ISO 8601周（范围01,53）。在IS0 8601周内从星期一开始，并且一年中的第一周必须满足以下要求：包括1月4日包括今年的第一个星期四| tm_year，tm_wday，tm_yday |

| OV（C99）| 写出一年中的一周，如％V所示，使用替代数字系统，例如ja_JP语言环境中的五十二而不是52。tm_year，tm_wday，tm_yday |

| 一年中的每月|

| j | 写一年中的一天作为十进制数（范围001,366）| tm_yday |

| d | 将月份的日期写为十进制数（范围为01,31）| tm_mday |

| Od（C99）| 使用替代数字系统写出从零开始的一天的日期，例如ja_JP语言环境中的二十七而不是23。单个字符前面有一个空格。| tm_mday |

| e（C99）| 将月份的日期写为十进制数（范围1,31）。单个数字前面有一个空格。| tm_mday |

| Oe（C99）| 使用替代数字系统写一个月的一天，例如ja_JP语言环境中的二十七而不是27。单个字符前面有一个空格。| tm_mday |

| 一周中的星期几|

| a | 写缩写的星期几名称，例如Fri（locale dependent）| tm_wday |

| A | 写完整的星期几名称，例如Friday（locale dependent）| tm_wday |

| w | 写星期几作为十进制数，星期日为0（范围0-6）| tm_wday |

| Ow（C99）| 写星期几，星期日为0，使用替代数字系统，例如ja_JP locale |中的二而不是2 tm_wday |

| 你（C99）| 写星期几作为十进制数，星期一为1（ISO 8601格式）（范围1-7）| tm_wday |

| Ou（C99）| 写星期几，星期一为1，使用替代数字系统，例如ja_JP locale |中的二而不是2 tm_wday |

| 小时，分钟，秒|

| H | 将小时数写为十进制数，24小时制（范围00-23）| tm_hour |

| OH（C99）| 使用替代数字系统从24小时制写小时，例如ja_JP locale |中的十八而不是18 tm_hour |

| 我| 将小时数写为十进制数，12小时制（范围01,12）| tm_hour |

| OI（C99）| 使用替代数字系统从12小时时钟写入小时，例如ja_JP locale中的六而不是06 tm_hour |

| M | 将分钟写入十进制数（范围为00,59）| tm_min |

| OM（C99）| 使用替代数字系统写分钟，例如ja_JP locale |中的二十五而不是25 tm_min |

| S | 写第二个作为十进制数（范围00,60）| tm_sec |

| OS（C99）| 使用替代数字系统写第二个，例如ja_JP locale |中的二十四而不是24 tm_sec |

| 其他|

| c | 写标准的日期和时间字符串，例如Sun 10月17日04:41:13 2010（取决于语言环境）| 全部|

| Ec（C99）| 写替代日期和时间字符串，例如在ja_JP语言环境中使用平成23年（平成23年）而不是2011年（2011年）全部|

| x | 写本地化的日期表示法（依赖于语言环境）| 全部|

| Ex（C99）| 写替代日期表示法，例如在ja_JP语言环境中使用平成23年（平成23年）而不是2011年（2011年）全部|

| X | 写本地化的时间表示（区域依赖）| 全部|

| EX（C99）| 写入替代时间表示（取决于语言环境）| 全部|

| D（C99）| 相当于“％m /％d /％y”| tm_mon，tm_mday，tm_year |

| F（C99）| 相当于“％Y-％m-％d”（ISO 8601日期格式）| tm_mon，tm_mday，tm_year |

| r（C99）| 写本地化的12小时时钟时间（取决于语言环境）| tm_hour，tm_min，tm_sec |

| R（C99）| 相当于“％H：％M”| tm_hour，tm_min |

| T（C99）| 相当于“％H：％M：％S”（ISO 8601时间格式）| tm_hour，tm_min，tm_sec |

| p | 写本地化的上午或下午（区域依赖）| tm_hour |

| z（C99）| 写入ISO 8601格式的UTC偏移量（例如-0430），如果时区信息不可用，则不显示字符| tm_isdst |

| Z | 写时区名称或缩写，或者如果时区信息不可用（取决于语言环境），则为无字符| tm_isdst |

• 包括1月4日

tm_year, tm_wday, tm_yday g

（C99）写出ISO 8601以周为单位的年份的后两位数字，即包含指定周（范围[00,99]）的年份。在IS0 8601周内从星期一开始，一年的第一周必须满足以下要求：

• 包括1月4日

tm_year，tm_wday，tm_yday 月 b 写缩写的月份名称，例如Oct（位置有关） tm_mon h

（C99）b tm_mon B 写完整月份名称的同义词，例如October（区域设置相关） tm_mon m 将月份写为十进制数（范围[01,12]） tm_mon Om

（C99）写道月使用可替代数字系统，如十二代替12 Ja_JP表示区域 tm_mon 周 U 写了一年的星期为十进制数（星期日是一周的第一天）（范围[00,53]） tm_year，tm_wday，tm_yday OU

（C99）写道一周年通过，%U使用替代的数字系统，如五十二，而不是在Ja_JP表示区域52 tm_year，tm_wday，tm_yday W 写了一年的星期为十进制数（星期一是一周的第一天）（范围[00,53]） tm_year，tm_wday，tm_yday OW

（C99）写道星期的一年，通过%W使用替代的数字系统，如五十二，而不是在Ja_JP表示区域52 tm_year，tm_wday，tm_yday V

（C99）写入一年中的ISO 8601周（范围[01,53]）。在IS0 8601周内从星期一开始，一年的第一周必须满足以下要求：

• 包括1月4日

tm_year, tm_wday, tm_yday OV

（C99）写入周一年中通过，%V使用替代的数字系统，例如五十二代替Ja_JP表示区域52 tm_year，tm_wday，tm_yday 年/月的日 j 写入一年中的哪一天为十进制数（范围[001,366]） tm_yday d 写入日作为十进制数（范围[01,31]） 的月份tm_mday Od

（C99）使用替代数字系统编写月份的零基日期，例如ja_JP语言环境中的二十七而不是23。单个字符前面有一个空格。

tm_mday e

（C99）以十进制数（范围）的形式写入当月的某天[1,31]。单个数字前面有一个空格。

tm_mday Oe

（C99）使用替代数字系统写一个月的一天，例如ja_JP语言环境中的二十七而不是27。单个字符前面有一个空格。

tm_mday 星期 a 写简写的星期名称，例如Fri（位置有关） tm_wday A 写完整的星期几的名称，如Friday（位置有关） tm_wday w 写入平日的十进制数，星期日为0（范围[0-6]） tm_wday Ow

（C99）使用替代数字系统写周日，其中星期日是0，例如ja_JP语言环境中的二而不是2 tm_wday u

（C99）将星期几写为十进制数，星期一为1（ISO 8601格式）（范围[1-7]） tm_wday Ou

（C99）写入平日，其中星期一是1，使用备选数字系统，例如，二，而不是在区域设置Ja_JP表示2 tm_wday 时，分，秒 H 写入小时为十进制数，24小时时钟（范围[00-23]） tm_hour OH

（C99）写入小时从24小时时钟使用备选数字系统，例如十八代替18的区域设置Ja_JP表示 tm_hour I 写入小时为十进制数，12个小时的时钟（范围[01,12]） tm_hour OI

（C99）使用替代数字系统从12小时时钟写入小时，例如ja_JP语言环境中的六而不是06 tm_hour M 写入分钟数（范围[00,59]） tm_min OM

（C99）使用替代数字系统写入分钟，例如ja_JP语言环境中的二十五而不是25 tm_min S 写入第二个作为十进制数（范围[00,60]） tm_sec OS

（C99）使用替代数字系统写第二个，例如ja_JP语言环境中的二十四而不是24个 tm_sec 其他 c 写入标准日期和时间字符串，例如Sun Oct 17 04:41:13 2010（取决于语言环境）全部 Ec

（C99）写入备选日期和时间字符串，例如在ja_JP语言环境中使用平成23年（年平成23年）而不是2011年（2011年），全部 x 写入本地化日期表示（与语言环境有关）全部 Ex

（C99）在ja_JP语言环境中使用平成23年（年平23）而不是2011年（2011年）编写替代日期表示法，全部 X 写入本地时间表示（与语言环境有关）全部 EX

（C99）全部写入替代时间表示（区域依赖） D

（C99），相当于“％米/％d /％Y” ， ，tm_montm_mdaytm_year F

（C99），相当于“％Y-％间- ％d” （在ISO 8601的日期格式） tm_mon，tm_mday，tm_year r

（C99）写入局部12小时制的时间（当前位置有关） tm_hour，tm_min，tm_sec R

（C99）相当于“％H：％M” tm_hour，tm_min T

（C99），相当于“％H：％M：％S” （在ISO 8601时间格式） tm_hour，tm_min，tm_sec p 写入局部上午或下午（当前位置有关） tm_hour z

（C99）以ISO 8601格式（例如）写入UTC的偏移量，-0430如果时区信息不可用，则不tm_isdst Z 写入字符; 写入时区名称或缩写 ; 如果时区信息不可用，则 写入无字符（取决于语言环境） tm_isdst

返回值

指向宽字符数组的宽字符数str不包括终止L'\0'成功。如果count在整个字符串可以存储之前达到，​0​则返回并且内容未定义。

例

#include <stdio.h>
#include <time.h>
#include <wchar.h>
#include <locale.h>
 
int main(void)
{
    wchar_t buff[40];
    struct tm my_time = { .tm_year=112, // = year 2012
                          .tm_mon=9,    // = 10th month
                          .tm_mday=9,   // = 9th day
                          .tm_hour=8,   // = 8 hours
                          .tm_min=10,   // = 10 minutes
                          .tm_sec=20    // = 20 secs
    };
 
    if (wcsftime(buff, sizeof buff, L"%A %c", &my_time)) {
        printf("%ls\n", buff
    } else {
        puts("wcsftime failed"
    }
 
    setlocale(LC_ALL, "ja_JP.utf8"
 
    if (wcsftime(buff, sizeof buff, L"%A %c", &my_time)) {
        printf("%ls\n", buff
    } else {
        puts("wcsftime failed"
    }
}

输出：

Sunday Sun Oct  9 08:10:20 2012
日曜日 2012年10月09日 08時10分20秒

参考

• C11标准（ISO / IEC 9899：2011）：