dateFormat

dateFormat 属性标识日期格式。

有效值如下所示:
"pattern"
pattern 值由一组字符组成,如日期、时间和时间戳记格式说明符中所述。

可从完整日期说明的开头或结尾删除字符,但不能从该说明的中间删除字符。

defaultDateFormat
如果对页面字段指定此选项,则 defaultDateFormat 的值是运行时 Java™ 语言环境中指定的日期格式。如果对表单字段指定此选项,则缺省模式等同于选择 systemGregorianDateFormat
eurDateFormat
模式“dd.MM.yyyy”,这是 IBM® 欧洲标准日期格式。
isoDateFormat
模式“yyyy-MM-dd”,这是国际标准组织(ISO)指定的日期格式。
jisDateFormat
模式“yyyy-MM-dd”,这是日本工业标准日期格式。
usaDateFormat
模式“MM/dd/yyyy”,这是 IBM 美国标准日期格式。
systemGregorianDateFormat
8 个或 10 个字符的模式,它包括 dd(表示数字格式的天)、MM(表示数字格式的月份)和 yy 或 yyyy(表示数字格式的年份),并将 d、M、y 或数字以外的字符用作分隔符。
格式在以下 Java 运行时属性中:
  vgj.datemask.gregorian.long.NLS
NLS
Java 运行时属性 vgj.nls.code 中指定的(本地语言支持)代码。此代码是 targetNLS 中列示的代码之一。不支持大写英语(代码 ENP)

有关 vgj.nls.code 的详细信息,请参阅 Java 运行时属性(详细信息)

systemJulianDateFormat
6 个或 8 个字符的模式,它包含 DDD(表示数字格式的天)和 yy 或 yyyy (表示数字格式的年份),并将 D、y 或数字以外的字符用作分隔符。
格式在以下 Java 运行时属性中:
  vgj.datemask.julian.long.NLS
NLS
Java 运行时属性 vgj.nls.code 中指定的(本地语言支持)代码。此代码是 targetNLS 中列示的代码之一。不支持大写英语(代码 ENP)

有关 vgj.nls.code 的详细信息,请参阅 Java 运行时属性(详细信息)

该属性在 DataItem 部件中可用,并且对出现在下列上下文中的字段有意义:
此属性用于输入和输出,但在下列情况下不使用此属性:

内部日期格式

当用户输入有效数据时,日期将从对此字段指定的格式转换为内部格式,以便用于后续验证。

字符日期的内部格式与系统缺省格式相同,并且包含分隔符。

对于数字日期,内部格式如下所示:
  • 对于格里历短日期,内部格式为 00yyMMdd
  • 对于格里历长日期,内部格式为 00yyyyMMdd
  • 对于儒略历短日期,内部格式为 0yyDDD
  • 对于儒略历长日期,内部格式为 0yyyyDDD

日期的长度注意事项

在表单中,表单的字段长度必须与您指定的字段掩码的长度相匹配。该字段的长度必须足以容纳日期的内部格式。

在页面字段中,规则如下所示:
  • 字段长度必须足以容纳指定的日期掩码,但可以更长
  • 对于数字字段,长度计算不考虑分隔符。

下表提供了示例。

格式类型 示例 表单字段的长度 页面字段(字符类型)的最小长度 页面字段(数字类型)的有效长度
短格里历 yy/MM/dd 8 8 6
长格里历 yyyy/MM/dd 10 10 8
短儒略历 DDD-yy 6 6 5
长儒略历 DDD-yyyy 8 8 7

日期的 I/O 注意事项

将对输入到变量字段中的数据进行检查,以确保日期是按指定格式输入的。用户不需要对日期和月份输入前导零,而是可以指定 8/5/1996(示例)而不是 08/05/1996。然而,省略分隔符的用户必须输入全部前导零。

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.