跳到主要内容

日期转字符串函数

=date2Str(date, format, offset)

version 1.7.5+ date 20240425

说明:返回格式化后的时间字符串

参数描述
date时间字符串,格式必须如 年-月-日 时:分:秒例:2021-08-11 12:00:01,也可以不传,不传取当前时间
format格式化字符串,默认格式为yyyy-MM-dd HH:mm:ss,如果设置了date参数的值,该参数必须传
offset数值偏移量,可以为负数,如果format 为单值(yyyyMMdd HHmmss),只对format(年/月/日/时/分/秒)的值计算,如果format 是混合格式,则按天计算。 如果设置了date参数的值,该参数必须传,可以传0。

所有示例已列出,使用时参考文档传递相同类型的参数,其他形式的传参均不支持: 假设当前时间为 2020-08-11 12:00:01

  • 不传参数 =date2Str() 获取的值为:2020-08-11 12:00:01
  • 只传1个参数: =date2Str('yyyy-MM-dd') 获取的值为: 2020-08-11
  • 传2个参数 =date2Str('MM', 2) 获取的值为:10 =date2Str('dd', -1) 获取的值为:10
  • 传3个参数 =date2Str('2020-08-15 12:00:01', 'yyyy-MM-dd', 1) 获取的值为:2020-08-16 =date2Str('2020-08-15 12:00:01', 'MM', 1) 获取的值为:9

升级功能:
=date2Str('yyyy-MM', -1) 获取的值为:2020-07

注意:关于时间计算 数值偏移量offset设置,如果当前月是12月,offset设置为1,format为MM, 则最终获取的值是1,日期,小时,分钟,秒均适用此规则。