Appearance

FormatDate ​

根据指定的格式化字符串返回格式化后的时间。

业务属性 ​

属性含义说明输入限定示例值
enable是否启用该控件，未启用时不编译是否编译选择值启用
name控件返回值命名控件输出值变量名常量difftime
text与控件关联的文本设计页控件显示常量difftime
date时间常量/流程变量#{date}
format格式化时间表达式常量/流程变量%Y-%m-%d

目前仅支持以下四种时间格式：

  • yyyyMMdd
  • yyyy-MM-dd
  • yyyyMMddHHmmss
  • yyyy-MM-dd HH:mm:ss

不符合以上格式的时间都将抛出illegal date format异常。

格式化字符串由常量字符串及表达式组成。

表达式规则如下表：

格式字符含义
%a一星期中天数的简写（例如：Wed）
%A一星期中天数的全称（例如：Wednesday）
%b月份的简写（例如：Sep）
%B月份的全称（例如：September）
%c日期和时间（例如：07/30/15 16:57:24）
%d一个月中的第几天[01 ~ 31]
%H24小时制中的小时数[00 ~ 23]
%I12小时制中的小时数[01 ~ 12]
%j一年中的第几天[001 ~ 366]
%M分钟数[00 ~ 59]
%m月份数[01 ~ 12]
%p“上午（am）”或“下午（pm）”
%S秒数[00 ~ 59]
%w一星期中的第几天[1 ~ 7 = 星期天 ~ 星期六]
%x日期（例如：07/30/15）
%X时间（例如：16:57:24）
%y两位数的年份[00 ~ 99]
%Y完整的年份（例如：2015）
%%字符'%'

使用示例 ​

输入常量 ​

时间输入：2023-11-11 11:11:11，表达式输入：%Y-%m-%d

img_3.png

输出控件返回FormatDate，data属性为：

json
{
  "formatDate": "#{formatDate}"
}
{
  "formatDate": "#{formatDate}"
}
img_4.png

使用curl请求接口：

$ curl http://localhost:6636/api/formatDate
$ curl http://localhost:6636/api/formatDate

接口返回：

json
{
    "formatDate": "2023-11-11"
}
{
    "formatDate": "2023-11-11"
}

输入指定变量 ​

时间输入：#{body.time}，表达式输入：#{body.format}

img_5.png

使用curl请求接口：

$ curl http://localhost:6636/api/formatDate -d "{ \"time\": \"2023-11-11 11:11:11\", \"format\": \"today is %A, in %B\" }"
$ curl http://localhost:6636/api/formatDate -d "{ \"time\": \"2023-11-11 11:11:11\", \"format\": \"today is %A, in %B\" }"

接口返回：

json
{
    "formatDate": "today is Saturday, in November"
}
{
    "formatDate": "today is Saturday, in November"
}