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.