format （日期格式） · Elasticsearch 5.4 中文文檔

# format （日期格式）原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-date-format.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-date-format.html) 譯文鏈接 : [format （日期格式）](/pages/viewpage.action?pageId=10028665) 貢獻者 : [程威](/display/~chengwei)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 在 **JSON**?文檔中,日期表示為字符串.**Elasticsearch**?使用一組預先配置的格式來識別和解析這些字符串表示為?**milliseconds-since-the-epoch in UTC.** 除了內置格式,你可以使用熟悉的 **yyyy/MM/dd** 語法指定自己的自定義格式. ``` curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "my_type": { "properties": { "date": { "type": "date", "format": "yyyy-MM-dd" } } } } } ' ``` 支持日期值的許多API還支持日期數學表達式,例如 **now-1m/d** ，即當前時間,減去一個月,向下舍入到最近的一天. tip 格式設置在相同索引中相同名稱的字段要有相同的設置.可以使用 **[PUT mapping API](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-put-mapping.html "Put Mapping")** 在現有字段上更新其值. ## Custom date formats （標準的日期格式）支持完全可定制的日期格式,這些語法**?[in the Joda docs](http://www.joda.org/joda-time/apidocs/org/joda/time/format/DateTimeFormat.html).** ## Built In Formats （以格式化構建）以下大多數日期都有嚴格的伴隨日期,這意味著,本周的年月日必須有前置的零數字才有效.這意味著,像5/11/1這樣的日期是無效的,你需要制定完整的日期,例如2005/11/01。所以,你需要指定 **strict_date_optional_time（**嚴格的日期選擇）來代替 ?**date_optional_time** . 下表列出了支持的所有默認ISO格式: **`epoch_millis`** ?一個毫秒的格式化程序.請注意,這個時間戳受?**Java?`Long.MIN_VALUE和`**?**`Long.MAX_VALUE限制.`** `epoch_second` .一個秒的格式化程序.請注意,時間戳受?**Java?`Long.MIN_VALUE和`**?**`Long.MAX_VALUE`**`限制.**MAX_VALUE** 除以**1000**（一秒鐘的毫秒數）.` [`date_optional_time`?or?`strict_date_optional_time`](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/mapping-date-format.html#strict-date-time) ``` 通用 ISO 日期時間解析器，其中日期是必需的，時間是可選的。 ``` [Full details here](http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateOptionalTimeParser--).`basic_date` 一個對完整日期的格式化,四位數字年份,兩位數字的月份,兩位數字的日期:?**yyyMMdd** `basic_date_time` 一個包含基本日期和時間的格式化程序,通過'T'分割：**`yyyyMMdd'T'HHmmss.SSSZ`**. `basic_date_time_no_millis` 一個包含基本日期和時間且沒有毫秒的格式化程序,通過 ‘T’ 分割：**yyyyMMdd'T'HHmmssZ.** `basic_ordinal_date` 一個用于?**ordinal date** 的格式化程序，使用四位數字的年份和三位數的日期，yyyyDDD。 `basic_ordinal_date_time` 一個用于完整的?**ordinal** 日期和時間的格式化程序,使用四位數的年份和三位數的日期:?**`yyyyDDD'T'HHmmss.SSSZ`.** `basic_ordinal_date_time_no_millis` 一個用于完整的?**ordinal**?日期和時間且沒有毫秒的格式化程序,使用四位數的年份和三位數的日期:?**`yyyyDDD'T'HHmmssZ`.** `basic_time` 一個兩位數的小時,兩位數的分鐘,兩位數的秒,三位數的毫秒以及時間偏移量的格式化程序:**HHmmss.SSSZ.** `basic_time_no_millis` 一個兩位數的小時,兩位數的分鐘,兩位數的秒以及時間偏移量的格式化程序:**HHmmssZ** `basic_t_time` 一個兩位數的小時,兩位數的分鐘,兩位數的秒,三位數的毫秒以及以T為前綴的時區：**`'T'HHmmss.SSSZ`**. `basic_t_time_no_millis` `一個兩位數的小時,兩位數的分鐘,兩位數的秒以及以T為前綴的時區：**'T'HHmmssZ**`. `basic_week_date`?or?`strict_basic_week_date` 一個四位數的weekyear,兩位數的周數,一位數的天數:**xxxx'W'wwe。** `basic_week_date_time`?or?`strict_basic_week_date_time` 一個包含基礎的 weekyear 日期和時間的格式化程序,通過T分割:?**`xxxx'W'wwe'T'HHmmss.SSSZ`.** `basic_week_date_time_no_millis`?or?`strict_basic_week_date_time_no_millis` 一個包含基礎的?weekyear 日期和時間且不包含毫秒的格式化程序,通過T分割?:**?`xxxx'W'wwe'T'HHmmssZ`**. `date`?or?`strict_date` 一個完整日期的格式化程序,四位數的年,兩位數的月,兩位數的天:?`**yyyy-MM-dd**.` `date_hour`?or?`strict_date_hour` 一個包含完整日期和兩位數的小時的格式化程序:?**`yyyy-MM-dd'T'HH`.** `date_hour_minute`?or?`strict_date_hour_minute` 一個包含完整日期,兩位數的天數,兩位數的分鐘的格式化程序: ?**`yyyy-MM-dd'T'HH:mm`.** `date_hour_minute_second`?or?`strict_date_hour_minute_second` 一個包含完整日期,兩位數的天數,兩位數的分鐘,兩位數的秒數:?**`yyyy-MM-dd'T'HH:mm:ss`**. `date_hour_minute_second_fraction`?or?`strict_date_hour_minute_second_fraction` 一個包含完整日期,兩位數的小時數,兩位數的分鐘數,兩位數的秒數,三位數的秒的分數：**`yyyy-MM-dd'T'HH:mm:ss.SSS`.** `date_hour_minute_second_millis`?or?`strict_date_hour_minute_second_millis` 一個包含完整日期,兩位數的小時,兩位數的分鐘,兩位數的秒數,三位數的秒的分數:?**`yyyy-MM-dd'T'HH:mm:ss.SSS`.** `date_time`?or?`strict_date_time` 一個包含完整日期和時間,通過T分割的格式化程序:?**`yyyy-MM-dd'T'HH:mm:ss.SSSZZ`.** `date_time_no_millis`?or?`strict_date_time_no_millis` 一個包含完整日期和時間且沒有毫秒的,通過T分割的格式化程序:?**`yyyy-MM-dd'T'HH:mm:ssZZ`.** `hour`?or?`strict_hour` 一個兩位數的小時數的格式化程序:?**HH** `hour_minute`?or?`strict_hour_minute` 一個兩位數的小時數和兩位數的分鐘數:`HH:mm`. `hour_minute_second`?or?`strict_hour_minute_second` 一個兩位數的小時數,兩位數的分鐘數和兩位數的秒數:`HH:mm:ss`. `hour_minute_second_fraction`?or?`strict_hour_minute_second_fraction` 一個兩位數的小時數,兩位數的分鐘數,兩位數的秒數，三位數的秒的分數:`HH:mm:ss.SSS`. `hour_minute_second_millis`?or?`strict_hour_minute_second_millis` 一個兩位數的小時數,兩位數的分鐘數,兩位數的秒數,三位數的秒的分數:?`HH:mm:ss.SSS`. `ordinal_date`?or?`strict_ordinal_date` 一個完整日期的格式化程序,使用四位數的年數和三位數年的天數:`yyyy-DDD`. `ordinal_date_time`?or?`strict_ordinal_date_time` 一個完整ordinal 日期和時間的格式化程序,使用四位數的年數和三位數的天數:`yyyy-DDD'T'HH:mm:ss.SSSZZ`. `ordinal_date_time_no_millis`?or?`strict_ordinal_date_time_no_millis` 一個完整日期和時間沒有毫秒的格式化程序,使用四位數的年份和三位數的年的天數：?`yyyy-DDD'T'HH:mm:ssZZ`. `time`?or?`strict_time` 一個兩位數的天數,兩位數的小時,兩位數的秒,三位數的秒的分數,以及時間偏移量：`HH:mm:ss.SSSZZ`. `time_no_millis`?or?`strict_time_no_millis` 一個兩位數的小時,兩位數的分鐘,兩位數的秒以及時間偏移量:`HH:mm:ssZZ`. `t_time`?or?`strict_t_time` 一個兩位數的小時,兩位數的分鐘,兩位數的秒,三位數的秒的分數以及以T為前綴的時間偏移量:?`'T'HH:mm:ss.SSSZZ`. `t_time_no_millis`?or?`strict_t_time_no_millis` 一個兩位數的小時,兩位數的分鐘,兩位數的秒以及以T為前綴的時間偏移量:`'T'HH:mm:ssZZ`. `week_date`?or?`strict_week_date` 一個完整日其的格式化程序,四位數的weekyear,兩位數的周數,一位數的天數：?`xxxx-'W'ww-e`. `week_date_time`?or?`strict_week_date_time` 一個包含完整weekyear 日期和時間的格式化程序,通過T進行分割：`xxxx-'W'ww-e'T'HH:mm:ss.SSSZZ`. `week_date_time_no_millis`?or?`strict_week_date_time_no_millis` 一個包含完整?weekyear 日期和時間沒有毫秒,以T分割的格式化程序:?`xxxx-'W'ww-e'T'HH:mm:ssZZ`. `weekyear`?or?`strict_weekyear` 一個四位數的?weekyear 的格式化程序:xxxx `weekyear_week`?or?`strict_weekyear_week` 一個四位數的?weekyear 和兩位數的周數:`xxxx-'W'ww`. weekyear_week_day?or?strict_weekyear_week_day 一個四位數的weekyear 兩位數的周數,一位數的天數:?`xxxx-'W'ww-e`. `year`?or?`strict_year` 一個四位數年份的格式化程序:yyyy. `year_month`?or?`strict_year_month` 一個四位數年份和兩位數月份的格式化程序:?`yyyy-MM`. `year_month_day`?or?`strict_year_month_day` 一個四位數的年份和兩位數的月份,兩位數的天數的格式化程序：`yyyy-MM-dd`.