可视化元件手册

  1. 首页
  2. 全部文档
  3. 可视化元件手册
  4. 日期时间元件(20个)
  5. Format Date and Time日期时间转字符串

Format Date and Time日期时间转字符串

名称:

Format Date and Time | 日期时间转字符串

图标:

功能:

  • 输入日期或日期时间值,按一定的模板转为字符串
  • 可以在模板中设计更多内容来替换时间数字,比如设计一个打印的标签时,将打印时间说明也放入模板中,如模板为“请注意,此单据打印时间为yyyy年MM月dd日,有问题请在3日内联系我店处理,谢谢”

使用方式:

调用模板将日期数字转为字符值

输入

  • <Date and Time>:日期时间类型值的输入,单数,必须项;要转为字符串的日期时间
  • <Format>:字符类型值的输入,单数,必须项;输入字母代替日期时间数字的模板内容
  • <Time Zone>:字符类型值的输入,单数,非必须项;输入时区名称,也可直接在模板中定义时区
  • <Time Zone Offset>:数字类型值的输入,单数,非必须项;输入标准时区的加时数字,注意数字单位是分钟数(比如北京时间就是GMT+8小时,则为480分钟)
  • 输入元件中的时区输入元件和标准时间加时数字输入元件可以删除不用,因为正常系统调用日期时间都是服务器所在地时间,一般都是当地时间
  • 模板中用字母代替数了的字母使用参考:http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html
    使用时参考以下字符来自定义模板

    字符 日期或时间 代表含义 示例
    G Era designator Text AD
    y Year Year 1996; 96
    Y Week year Year 2009; 09
    M Month in year Month July; Jul; 07
    w Week in year Number 27
    W Week in month Number 2
    D Day in year Number 189
    d Day in month Number 10
    F Day of week in month Number 2
    E Day name in week Text Tuesday;
    u Day number of week(1 = Monday, …, 7 = Sunday) Number 1
    a Am/pm marker Text PM
    H Hour in day (0-23) Number
    k Hour in day (1-24) Number
    K Hour in am/pm (0-11) Number
    h Hour in am/pm (1-12) Number
    m Minute in hour Number 30
    s Second in minute Number 55
    S Millisecond Number 978
    z Time zone General time zone Pacific Standard Time; PST; GMT-08:00
    Z Time zone RFC 822 time zone -0800
    X Time zone ISO 8601 time zone -08; -0800; -08:00

输出:

  • <Text>:字符类型值的输出,单数,必须项;将模板中的日期时间字母用输入的日期时间数字替换生成字符串并输出
    日期时间模板 输出结果
    “yyyy.MM.dd G ‘at’ HH:mm:ss z” 2001.07.04 AD at 12:08:56 PDT
    “EEE, MMM d, ”yy” Wed, Jul 4, ’01
    “h:mm a” 12:08 PM
    “hh ‘o”clock’ a, zzzz” 12 o’clock PM, Pacific Daylight Time
    “K:mm a, z” 0:08 PM, PDT
    “yyyyy.MMMMM.dd GGG hh:mm aaa” 02001.July.04 AD 12:08 PM
    “EEE, d MMM yyyy HH:mm:ss Z” Wed, 4 Jul 2001 12:08:56 -0700
    “yyMMddHHmmssZ” 010704120856-0700
    “yyyy-MM-dd’T’HH:mm:ss.SSSZ” 2001-07-04T12:08:56.235-0700
    “yyyy-MM-dd’T’HH:mm:ss.SSSXXX” 2001-07-04T12:08:56.235-07:00
    “YYYY-‘W’ww-u” 2001-W27-3

示例:

案例:日期时间转为文本

任意一个项目的目录“Common/Templates/Dates/Format Date and Time/Test 1/Test 1”中: