Salesforce中的日期格式、字面日期以及大小限制
前言
文章直接翻译自Salesforce开发者页面,原页面很详细,可惜是英文的可能很多人有阅读的障碍,所以翻译成中文,好理解!实际上,原文是针对SOQL查询的,并不是针对一前端网页用户。但是在前端我们使用Salesforce时,也可以使用这样的日期格式或者字面日期,只要转换一下就行非常方便。
典型的字面日期包括:YESTERDAY, TODAY, THIS_WEEK, LAST_MONTH, NEXT_QUARTER, and THIS_FISCAL_YEAR等,这是SOQL查询语句用的。换成前端用户的话,只需要把下下划线\_替换成空格 就行。举例LAST_MONTH变成LAST MONTH.
日期格式
纯日期
格式为 YYYY-MM-DD 例子是 2011-11-11
日期与时间、时区偏移混搭
格式
- YYYY-MM-DDThh:mm:ss+hh:mm 例子是 2011-11-11T11:11+1:00
- YYYY-MM-DDThh:mm:ss-hh:mm 例子是 2011-11-11T11:11-8:00
- YYYY-MM-DDThh:mm:ssZ 例子是 2011-11-11T11:11:11Z
注意:所有时区偏移都是从UTC算起的(可还记得本初子午线和格林威治) 具体可以查看下面两个网页:
http://www.w3.org/TR/xmlschema-2/#isoformats
http://www.w3.org/TR/NOTE-datetime
字面日期
这个就不得了了,为什么?因为实在有太多选择了(部分暂时不能使用在前端,其实前面的就够了):
- 字面日期(英文/SOQL) 中文(可以直接在前端网页中输入哦) 备注
- YESTERDAY 昨天
- TODAY 今天
- TOMORROW 明天
- LAST WEEK 上星期
- THIS_WEEK 本星期
- NEXT_WEEK 下星期
- LAST_MONTH 上月
- THIS_MONTH 本月
- NEXT_MONTH 下月
- LAST_90_DAYS 过去 90 天 (注意中间的空格,有数字的字面日期数字需要与前后文字均隔一个空格,下同)
- NEXT_90_DAYS 未来 90 天
- LAST_N_DAYS:n 过去 n 天 (n可以随便设置哦!下同)
- NEXT_N_DAYS:n 未来 n 天
- NEXT_N_WEEKS:n 未来 n 星期
- LAST_N_WEEKS:n 过去 n 星期
- NEXT_N_MONTHS:n 未来 n 个月
- LAST_N_MONTHS:n 过去 n 个月
THIS_QUARTER
LAST_QUARTER
NEXT_QUARTER
NEXT_N_QUARTERS:n
LAST_N_QUARTERS:n
THIS_YEAR
LAST_YEAR
NEXT_YEAR
NEXT_N_YEARS:n
LAST_N_YEARS:n
THIS_FISCAL_QUARTER
LAST_FISCAL_QUARTER
NEXT_FISCAL_QUARTER
NEXT_N_FISCAL_QUARTERS:n
LAST_N_FISCAL_QUARTERS:n
THIS_FISCAL_YEAR
LAST_FISCAL_YEAR
NEXT_FISCAL_YEAR
NEXT_N_FISCAL_YEARS:n
LAST_N_FISCAL_YEARS:n
日期限制(最大最小日期)
Saelsforce中的日期是有一个范围的,填入超过这个范围的日期不会被Salesforce接受,同时系统会报错。而在插入(Insert)一个对象时,日期错误可以直接导致整个插入失败。
Salesforce中最小日期为1700-01-01T00:00:00Z GMT, 最大日期为4000-12-31T00:00:00Z GMT.