# date_time_format_t

# 概述

格式化日期时间。

格式规则:

  • Y 代表年(完整显示)
  • M 代表月(1-12)
  • D 代表日(1-31)
  • h 代表时(0-23)
  • H 代表时(0-11)
  • m 代表分(0-59)
  • s 代表秒(0-59)
  • w 代表星期(0-6)
  • W 代表星期的英文缩写(支持翻译)
  • T 代表时段AM/PM(支持翻译)
  • YY 代表年(只显示末两位)
  • MM 代表月(01-12)
  • DD 代表日(01-31)
  • hh 代表时(00-23)
  • HH 代表时(00-11)
  • mm 代表分(00-59)
  • ss 代表秒(00-59)
  • MMM 代表月的英文缩写(支持翻译)

如 日期时间为:2018/11/12 9:10:20

  • "Y/M/D"显示为"2018/11/12"
  • "Y-M-D"显示为"2018-11-12"
  • "Y-M-D hⓂ️s"显示为"2018-11-12 9:10:20"
  • "Y-M-D hh:mm:ss"显示为"2018-11-12 09:10:20"

# 函数

函数名称 说明
wstr_format_date_time 格式化date_time。
wstr_format_time 格式化time。

# wstr_format_date_time 函数

  • 函数功能:

格式化date_time。

  • 函数原型:
ret_t wstr_format_date_time (wstr_t* str, const char* format, const date_time_t* dt);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
str wstr_t* 输出字符串。
format const char* 格式。
dt const date_time_t* 时间。

# wstr_format_time 函数

  • 函数功能:

格式化time。

  • 函数原型:
ret_t wstr_format_time (wstr_t* str, const char* format, uint64_t time);
  • 参数说明:
参数 类型 说明
返回值 ret_t 返回RET_OK表示成功,否则表示失败。
str wstr_t* 输出字符串。
format const char* 格式。
time uint64_t 时间。