ACIDateCheck()¶
-
ACIDateCheck()¶
作用:
检查日期的有效性
语法:
sword ACIDateCheck ( ACIError *err,
const ACIDate *date,
uword *valid );
参数:
- err (IN/OUT)
错误句柄,该接口调用失败时,错误信息会存在该句柄上 ,调用 ACIErrorGet 获得错误信息。
- date (IN)
将被检查的日期
- valid (OUT)
返回零表示有效日期; 否则它返回下表相关的值或组合值:
| 宏定义 | 值 | 对应错误信息 |
|---|---|---|
| ACI_DATE_INVALID_DAY | 0x1 | 错误的天数 |
| ACI_DATE_DAY_BELOW_VALID | 0x2 | 错误的天数且小于1 |
| ACI_DATE_INVALID_MONTH | 0x4 | 错误的月数 |
| ACI_DATE_MONTH_BELOW_VALID | 0x8 | 错误的月数且小于1 |
| ACI_DATE_INVALID_YEAR | 0x10 | 错误的年份 |
| ACI_DATE_YEAR_BELOW_VALID | 0x20 | 错误的年份且小于1 |
| ACI_DATE_INVALID_HOUR | 0x40 | 错误的小时数 |
| ACI_DATE_HOUR_BELOW_VALID | 0x80 | 错误的小时数且小于1 |
| ACI_DATE_INVALID_MINUTE | 0x100 | 错误的分钟数 |
| ACI_DATE_MINUTE_BELOW_VALID | 0x200 | 错误的分钟数且小于1 |
| ACI_DATE_INVALID_SECOND | 0x400 | 错误的秒数 |
| ACI_DATE_SECOND_BELOW_VALID | 0x800 | 错误的秒数且小于1 |
| ACI_DATE_DAY_MISSING_FROM_1582 | 0x1000 | 天数是从1582开始丢失的 |
| ACI_DATE_YEAR_ZERO | 0x2000 | 年不等于0 |
| ACI_DATE_INVALID_FORMAT | 0x8000 | 输入日期格式错误 |
例如,如果以(月/日/年小时:分钟:秒格式)传递的日期是2/0/1990 25:61:10,则返回的错误是:
ACI_DATE_INVALID_DAY | ACI_DATE_DAY_BELOW_VALID | ACI_DATE_INVALID_HOUR | ACI_DATE_INVALID_MINUTE
说明:
如果date日期或valid指针为NULL,则此函数返回错误