日期和時間格式

公共抽象類
的DateFormat
擴展格式
java.lang.Object的
↳ java.text.Format子
↳ java.text.DateFormat
已知的直接子類
SimpleDateFormat的
類概述

一個抽象類，日期/時間格式化子類的格式和解析日期或時間在一個語言無關的方式。日期/時間格式化子類，如SimpleDateFormat的，允許進行格式化（即日期- >文本），分析（文本- >日期）和標準化。作爲一個日期對象或1970年1月1日起，日00:00:00 GMT以來的毫秒錶示的日期。

DateFormat中提供了許多類的方法獲取默認的日期/時間格式化基於默認或給定的語言環境和格式樣式。包括完整的，長，中，短期和格式樣式。方法描述中提供更多的細節和使用這些樣式的例子。

的DateFormat幫助你格式化和分析任何語言環境的日期。個月，一週天，甚至日曆格式：月球與太陽，你的代碼可以是完全獨立的區域公約。

要格式化當前Locale的日期，使用靜態工廠方法之一：

myString的= 的DateFormat 。getDateInstance 。（）格式（myDate ）;

如果格式化多個日期，它是更有效地獲得該格式並多次使用，使系統不具備獲取信息，瞭解當地的語言和國家公約多次。



“ ）;
}

要格式化不同語言環境的一個數字，指定調用它 getDateInstance的：

DateFormat中DF = 的DateFormat （日期格式。長， 場所，法國）;

DateFormat中也可以用來解析字符串：

myDate = DF 。解析（myString的）;

使用getDateInstance獲得一個國家正常的日期格式。其他靜態工廠方法是：使用getTimeInstance得到一個國家的時間格式。使用getDateTimeInstance獲得日期和時間格式。在不同的選項，你可以通過這些工廠方法來控制結果的長度;從短期至中期長全。確切的結果取決於語言環境，但一般：

總之是完全的數字，如52年12月13日下午3:30
媒介是更長的時間，如1952年1月12日，
龍是時間，如1952年1月12日，或三時三十〇分32秒時，
全是幾乎完全指定，如週二，1952年4月12日，AD或下午3點30分42秒PST。
如果需要，可以設置時區上的格式。對於更大控制在格式化或解析，嘗試從工廠方法得到一個SimpleDateFormat的鑄造的DateFormat。這將工作的大多數國家，只記得它放在一個try塊的情況下，你遇到一個不尋常的。

有版本的解析和格式的方法使用 ，讓您 的ParsePosition和FieldPosition

逐步解析一個字符串件;
將任何特定的領域。
同步

日期格式不同步。建議爲每個線程創建獨立的格式實例。如果多個線程同時訪問一個格式，它必須保持外部同步。

參見

NumberFormat的
SimpleDateFormat的
日曆
時區
總結

嵌套類
類 DateFormat.Field 被用作屬性鍵和值的AttributedCharacterIterator的 formatToCharacterIterator（對象）的方法返回這個內部類的實例。
常量
INT AM_PM_FIELD FieldPosition選擇爲'一'字段對齊，對應的 AM_PM領域。
INT DATE_FIELD FieldPosition爲'D'字段對齊的選擇，“ 日期 “ 字段對應。
INT DAY_OF_WEEK_FIELD 的FieldPosition爲“E”字段對齊選擇，對應 DAY_OF_WEEK領域。
INT DAY_OF_WEEK_IN_MONTH_FIELD 的FieldPosition爲“F”字段對齊選擇，對應的 DAY_OF_WEEK_IN_MONTH領域。
INT DAY_OF_YEAR_FIELD 的FieldPosition爲“D”字段對齊選擇，對應的 DAY_OF_YEAR領域。
INT 默認 定義的默認格式樣式的格式風格不變。
INT ERA_FIELD FieldPosition爲“G”字段對齊選擇，對應的自責領域。
INT 全 格式定義完整的風格的風格不變。
INT HOUR0_FIELD FieldPosition爲“K”字段對齊選擇，對應的 小時字段。
INT HOUR1_FIELD FieldPosition選擇“H”字段對齊，對應的 小時字段。
INT HOUR_OF_DAY0_FIELD FieldPosition '轟'的字段對齊選擇，對應的HOUR_OF_DAY領域。
INT HOUR_OF_DAY1_FIELD FieldPosition爲'K'字段對齊選擇，對應的HOUR_OF_DAY領域。
INT 龍 確定長期的風格格式風格不變。
INT 介質 格式風格不變定義介質風格。
INT MILLISECOND_FIELD FieldPosition選擇“S”字段對齊，對應的 微差領域。
INT MINUTE_FIELD FieldPosition選擇爲“M”字段對齊，相當於每 分鐘領域。
INT MONTH_FIELD FieldPosition爲“M”字段對齊選擇，對應到一個月領域。
INT “SECOND_FIELD FieldPosition的'字段的對齊選擇，對應的 第二場。
INT 淡 格式定義短的風格的風格不變。
INT TIMEZONE_FIELD FieldPosition爲“Z”字段對齊選擇，對應的ZONE_OFFSET和DST_OFFSET 領域。
INT WEEK_OF_MONTH_FIELD 的FieldPosition爲“W”字段對齊選擇，對應的 WEEK_OF_MONTH領域。
INT WEEK_OF_YEAR_FIELD FieldPosition'W'字段對齊的選擇，對應的 WEEK_OF_YEAR領域。
INT YEAR_FIELD FieldPosition爲'Y'字段對齊選擇，對應的2003 年 7月至2004年6 。
領域
保護 日曆 日曆 日曆本的DateFormat用來格式化一個數字代表日期。
保護 的NumberFormat NumberFormat的 使用數字格式來格式化一個數字。
受保護的構造
的DateFormat（）
構造一個新的實例的DateFormat。
公共方法
物件 克隆（）
返回一個新的DateFormat實例具有相同的屬性。
布爾 等於（對象對象）
比較指定對象與此日期格式，並表示如果他們是平等的。
抽象 的StringBuffer 格式（日期日期，StringBuffer的緩衝區，FieldPosition場）
作爲一個使用此日期格式的字符串追加到指定的字符串緩衝區的模式的字符串格式指定的日期。
最後 的StringBuffer 格式（對象對象，StringBuffer的緩衝區，FieldPosition場）
格式指定的對象作爲字符串使用此日期格式的字符串追加到指定的字符串緩衝區的格局。
最後的 字符串 格式（日期日期）
格式化指定的日期，此日期格式的規則。
靜態 場所[] getAvailableLocales（）
返回的DateFormat實例是可用的語言環境而定製的數組。
日曆 getCalendar（）
返回本所使用的日曆的DateFormat。
最後靜態 的DateFormat getDateInstance（INT風格）
返回一個用於格式化和解析用戶的默認語言環境的日期指定樣式的DateFormat實例。
最後靜態 的DateFormat getDateInstance（INT風格，語言環境的語言環境）
返回一個DateFormat中的格式化和解析日期，在指定的樣式指定的語言環境的實例。
最後靜態 的DateFormat getDateInstance（）
返回一個用於格式化和解析日期默認語言環境的默認樣式的DateFormat實例。
最後靜態 的DateFormat getDateTimeInstance（INT，INT timeStyle DATESTYLE 區域設置區域設置）
返回一個用於格式化和解析日期和時間值在指定的區域設置指定的樣式的DateFormat實例。
最後靜態 的DateFormat getDateTimeInstance（INT DATESTYLE，詮釋timeStyle）
返回一個用於格式化和解析日期和時間值的方式爲用戶的默認語言環境的適當的DateFormat實例。
最後靜態 的DateFormat getDateTimeInstance（）
返回一個用於格式化和解析日期和時間值中的默認樣式爲默認語言環境的DateFormat實例。
最後靜態 的DateFormat 的getInstance（）
返回一個用於格式化和解析日期和時間在短期風格默認語言環境的DateFormat實例。
NumberFormat的 getNumberFormat（）
返回的NumberFormat使用的DateFormat。
最後靜態 的DateFormat getTimeInstance（INT風格）
返回一個用於格式化和解析用戶的默認語言環境的時間在指定的樣式值的DateFormat實例。
最後靜態 的DateFormat getTimeInstance（）
返回一個DateFormat中的默認樣式爲默認的語言環境中的時間值的格式化和解析實例。
最後靜態 的DateFormat getTimeInstance（INT風格，語言環境的語言環境）
返回一個用於格式化和解析指定的區域設置中指定的樣式的時間值的DateFormat實例。
時區 getTimeZone（）
返回此日期格式的日曆的時區。
INT 的hashCode（）
返回此對象的整數哈希代碼。
布爾 isLenient（）
表示此日期格式所使用的日曆是否是寬鬆的。
日期 字符串字符串（解析）
解析一個使用此日期格式的規則，從指定的字符串的日期。
抽象的 日期 解析（字符串字符串的ParsePosition位置）
解析一個從指定的字符串所指定的索引開始日期的位置。
物件 的parseObject（字符串字符串的ParsePosition位置）
解析一個從指定的字符串所指定的索引開始日期的位置。
無效 setCalendar（日曆 CAL）
設置此日期格式所使用的日曆。
無效 setLenient（布爾值）
指定解析日期/時間是否應寬鬆。
無效 setNumberFormat（NumberFormat的格式）
設置此日期格式所使用的NumberFormat。
無效 setTimeZone（TimeZone的時區）
此日期格式所使用的日曆設置時區。
[展開]
繼承的方法
從類 java.text.Format子
從類 java.lang.Object繼承
常量

公共靜態最終詮釋 AM_PM_FIELD

日期：API等級1
FieldPosition選擇爲'一'字段對齊，對應的 AM_PM領域。
恆值： 14（0x0000000e）
公共靜態最終詮釋 DATE_FIELD

日期：API等級1
FieldPosition爲'D'字段對齊的選擇，“ 日期 “ 字段對應。
常量的值： 3（0x00000003）
公共靜態最終詮釋 DAY_OF_WEEK_FIELD

日期：API等級1
的FieldPosition爲“E”字段對齊選擇，對應 DAY_OF_WEEK領域。
恆值： 9（0x00000009）
公共靜態最終詮釋 DAY_OF_WEEK_IN_MONTH_FIELD

日期：API等級1
的FieldPosition爲“F”字段對齊選擇，對應的 DAY_OF_WEEK_IN_MONTH領域。
恆值： 11（0x0000000b）
公共靜態最終詮釋 DAY_OF_YEAR_FIELD

日期：API等級1
的FieldPosition爲“D”字段對齊選擇，對應的 DAY_OF_YEAR領域。
恆值： 10（0X0000000A）
公共靜態最終詮釋 DEFAULT

日期：API等級1
定義的默認格式樣式的格式風格不變。默認是中等。
恆值： 2（0X00000002）
公共靜態最終詮釋 ERA_FIELD

日期：API等級1
FieldPosition爲“G”字段對齊選擇，對應的自責領域。
恆值： 0（0X00000000）
公共靜態最終詮釋 全

日期：API等級1
格式定義完整的風格的風格不變。
恆值： 0（0X00000000）
公共靜態最終詮釋 HOUR0_FIELD

日期：API等級1
FieldPosition爲“K”字段對齊選擇，對應的 小時字段。
恆值： 16（0x00000010）
公共靜態最終詮釋 HOUR1_FIELD

日期：API等級1
FieldPosition選擇“H”字段對齊，對應的 小時字段。
恆值： 15（0x0000000f）
公共靜態最終詮釋 HOUR_OF_DAY0_FIELD

日期：API等級1
FieldPosition '轟'的字段對齊選擇，對應的HOUR_OF_DAY領域。HOUR_OF_DAY0_FIELD從零開始的24小時時鐘。例如，23:59 + 00:59 01:00結果。
常量的值： 5（0x00000005）
公共靜態最終詮釋 HOUR_OF_DAY1_FIELD

日期：API等級1
FieldPosition爲'K'字段對齊選擇，對應的HOUR_OF_DAY領域。HOUR_OF_DAY1_FIELD是一個基於24小時時鐘。例如，23:59 + 24:59 01:00結果。
恆值： 4（0x00000004）
公共靜態最終詮釋 龍

日期：API等級1
確定長期的風格格式風格不變。
恆值： 1（0x00000001）
公共靜態最終詮釋 介質

日期：API等級1
格式風格不變定義介質風格。
恆值： 2（0X00000002）
公共靜態最終詮釋 MILLISECOND_FIELD

日期：API等級1
FieldPosition選擇“S”字段對齊，對應的 微差領域。
恆值： 8（0x00000008）
公共靜態最終詮釋 MINUTE_FIELD

日期：API等級1
FieldPosition選擇爲“M”字段對齊，相當於每 分鐘領域。
恆值： 6（0x00000006）
公共靜態最終詮釋 MONTH_FIELD

日期：API等級1
FieldPosition爲“M”字段對齊選擇，對應到一個月領域。
恆值： 2（0X00000002）
公共靜態最終詮釋 “SECOND_FIELD

日期：API等級1
FieldPosition的'字段的對齊選擇，對應的 第二場。
恆值： 7（0x00000007）
公共靜態最終詮釋 淡

日期：API等級1
格式定義短的風格的風格不變。
常量的值： 3（0x00000003）
公共靜態最終詮釋 TIMEZONE_FIELD

日期：API等級1
FieldPosition爲“Z”字段對齊選擇，對應的ZONE_OFFSET和DST_OFFSET 領域。
恆值： 17（0x00000011）
公共靜態最終詮釋 WEEK_OF_MONTH_FIELD

日期：API等級1
的FieldPosition爲“W”字段對齊選擇，對應的 WEEK_OF_MONTH領域。
恆值： 13（0x0000000d）
公共靜態最終詮釋 WEEK_OF_YEAR_FIELD

日期：API等級1
FieldPosition'W'字段對齊的選擇，對應的 WEEK_OF_YEAR領域。
恆值： 12（0x0000000c）
公共靜態最終詮釋 YEAR_FIELD

日期：API等級1
FieldPosition爲'Y'字段對齊選擇，對應的2003 年 7月至2004年6 。
恆值： 1（0x00000001）
領域

保護 日曆 日曆

日期：API等級1
日曆本的DateFormat用來格式化一個數字代表日期。
受保護的 NumberFormat的 NumberFormat的

日期：API等級1
使用數字格式來格式化一個數字。
受保護的構造

受保護 的DateFormat （）

日期：API等級1
構造一個新的實例的DateFormat。
公共方法

公共 對象 的clone （）

日期：API等級1
返回一個新的DateFormat實例具有相同的屬性。
返回

一個淺拷貝的DateFormat。
參見

Cloneable接口
公共布爾 等於 （對象對象）

日期：API等級1
比較指定對象與此日期格式，並表示如果他們是平等的。
參數

物件 此日期格式比較的對象。
返回

真實的，如果對象是的DateFormat對象，它具有相同的屬性，此日期格式; ， 否則返回false。
參見

hashCode（）方法
公共抽象 StringBuffer的 格式 （日期日期，StringBuffer的緩衝區，FieldPosition場）

日期：API等級1
作爲一個使用此日期格式的字符串追加到指定的字符串緩衝區的模式的字符串格式指定的日期。
如果該領域的成員字段指定格式字段包含一個值，然後將其beginIndex和endIndex的成員首次出現在這一領域的格式化文本的位置更新。
參數

日期 格式化的日期。
緩衝 目標字符串緩衝區，追加格式化的日期/時間。
場 ：一個可選的對齊字段輸入輸出：在格式化文本的對齊字段的偏移量。
返回

字符串緩衝區。
公衆最終 StringBuffer的 格式 （Object 對象，StringBuffer的緩衝區，FieldPosition場）

日期：API等級1
格式指定的對象作爲字符串使用此日期格式的字符串追加到指定的字符串緩衝區的格局。
如果該領域的成員字段指定格式字段包含一個值，然後將其beginIndex和endIndex的成員首次出現在這一領域的格式化文本的位置更新。
參數

物件 源對象的格式，必須是一個日期或一個 數字。如果對象是一個數字，然後構造一個日期使用的longValue（）的數量。
緩衝 目標字符串緩衝區，追加格式化的日期/時間。
場 ：一個可選的對齊字段輸入輸出：在格式化文本的對齊字段的偏移量。
返回

字符串緩衝區。
拋出

IllegalArgumentException 如果對象既不是一個日期，也不是一個 數量的實例。
公衆最終的 字符串 格式 （日期日期）

日期：API等級1
格式化指定的日期，此日期格式的規則。
參數

日期 格式化的日期。
返回

格式化字符串。
公共靜態 語言環境[] getAvailableLocales的 （）

日期：API等級1
返回的DateFormat實例是可用的語言環境而定製的數組。
請注意，Android不支持用戶提供本地化服務提供商。
公共的 日曆 getCalendar （）

日期：API等級1
返回本所使用的日曆的DateFormat。
返回

使用此日期格式的日曆。
公共靜態最後 的DateFormat getDateInstance （INT風格）

日期：API等級1
返回一個用於格式化和解析用戶的默認語言環境的日期指定樣式的DateFormat實例。參見“ 警惕的默認語言環境 “。
參數

風格 一個短期，中期，長期，全面，或DEFAULT。
返回

DateFormat中的實例樣式和默認語言環境。
拋出

IllegalArgumentException 如果風格是不是一個短期，中期，長期，全面，或DEFAULT。
公共靜態最後 的DateFormat getDateInstance （INT風格，語言環境的語言環境）

日期：API等級1
返回一個DateFormat中的格式化和解析日期，在指定的樣式指定的語言環境的實例。
參數

風格 一個短期，中期，長期，全面，或DEFAULT。
語言環境 語言環境。
返回

DateFormat中的實例的風格和 語言環境。
拋出

IllegalArgumentException 如果風格是不是一個短期，中期，長期，全面，或DEFAULT。
公共靜態最後 的DateFormat getDateInstance （）

日期：API等級1
返回一個用於格式化和解析日期默認語言環境的默認樣式的DateFormat實例。
返回

DateFormat中的默認樣式和區域的實例。
公共靜態最後 的DateFormat getDateTimeInstance （INT DATESTYLE，本地化的語言環境，詮釋timeStyle ）

日期：API等級1
返回一個用於格式化和解析日期和時間值在指定的區域設置指定的樣式的DateFormat實例。
參數

DATESTYLE 一個短期，中期，長期，全面，或DEFAULT。
timeStyle 一個短期，中期，長期，全面，或DEFAULT。
語言環境 語言環境。
返回

DateFormat中的的實例DATESTYLE， timeStyle和語言環境。
拋出

IllegalArgumentException 如果DATESTYLE，或timeStyle是不是一個短期，中期，長期，全面，或DEFAULT。
公共靜態最後 的DateFormat getDateTimeInstance （INT DATESTYLE，詮釋timeStyle）

日期：API等級1
返回一個用於格式化和解析日期和時間值的方式爲用戶的默認語言環境的適當的DateFormat實例。參見“ 警惕的默認語言環境 “。
參數

DATESTYLE 一個短期，中期，長期，全面，或DEFAULT。
timeStyle 一個短期，中期，長期，全面，或DEFAULT。
返回

DateFormat中的的實例DATESTYLE， timeStyle和默認語言環境。
拋出

IllegalArgumentException 如果DATESTYLE，或timeStyle是不是一個短期，中期，長期，全面，或DEFAULT。
公共靜態最後 的DateFormat getDateTimeInstance （）

日期：API等級1
返回一個用於格式化和解析日期和時間值中的默認樣式爲默認語言環境的DateFormat實例。
返回

DateFormat中的默認樣式和區域的實例。
公共靜態最後 的DateFormat 的getInstance （）

日期：API等級1
返回一個用於格式化和解析日期和時間在短期風格默認語言環境的DateFormat實例。
返回

DateFormat中的短的風格和默認語言環境的實例。
公衆 的NumberFormat getNumberFormat （）

日期：API等級1
返回的NumberFormat使用的DateFormat。
返回

此日期格式NumberFormat的使用。
公共靜態最後 的DateFormat getTimeInstance （INT風格）

日期：API等級1
返回一個用於格式化和解析用戶的默認語言環境的時間在指定的樣式值的DateFormat實例。參見“ 警惕的默認語言環境 “。
參數

風格 一個短期，中期，長期，全面，或DEFAULT。
返回

DateFormat中的實例樣式和默認語言環境。
拋出

IllegalArgumentException 如果風格是不是一個短期，中期，長期，全面，或DEFAULT。
公共靜態最後 的DateFormat getTimeInstance （）

日期：API等級1
返回一個DateFormat中的默認樣式爲默認的語言環境中的時間值的格式化和解析實例。
返回

DateFormat中的默認樣式和區域的實例。
公共靜態最後 的DateFormat getTimeInstance （INT風格，語言環境的語言環境）

日期：API等級1
返回一個用於格式化和解析指定的區域設置中指定的樣式的時間值的DateFormat實例。
參數

風格 一個短期，中期，長期，全面，或DEFAULT。
語言環境 語言環境。
返回

DateFormat中的實例的風格和 語言環境。
拋出

IllegalArgumentException 如果風格是不是一個短期，中期，長期，全面，或DEFAULT。
公衆 的TimeZone getTimeZone （）

日期：API等級1
返回此日期格式的日曆的時區。
返回

此日期格式所使用的日曆的時區。
公衆詮釋 的hashCode （）

日期：API等級1
返回此對象的整數哈希代碼。合同，任何兩個物體爲等於（對象）返回真，必須返回相同的哈希碼值。這意味着子類的對象， 通常覆蓋兩種方法既不方法。
請注意，哈希值必須不隨時間而改變，除非所用的信息equals比較中也發生了變化。
看到寫一個正確的 hashCode方法， 如果你打算實現自己的hashCode方法。
返回

此對象的哈希代碼。
公共布爾 isLenient （）

日期：API等級1
表示此日期格式所使用的日曆是否是寬鬆的。
返回

如果日曆是真正的寬鬆; ，否則返回false。
公開 日期 解析 （字符串字符串）

日期：API等級1
解析一個使用此日期格式的規則，從指定的字符串的日期。
參數

串 字符串解析。
返回

解析日期。
拋出

ParseException 如果出現錯誤，在解析過程中。
公共抽象的 日期 解析 （字符串字符串的ParsePosition位置）

日期：API等級1
解析一個從指定的字符串所指定的索引開始日期的位置。如果該字符串成功解析，那麼該指數的ParsePosition更新的指數解析文本。出現錯誤時，該指數保持不變，指數的ParsePosition的錯誤設置發生錯誤的位置的索引。
默認情況下，解析是寬鬆：如果輸入的是不是在此對象的格式化方法使用的形式，但仍然可以解析爲一個日期，然後解析成功。客戶可能堅持嚴格遵守格式致電setLenient（假）。
參數

串 字符串解析。
位置 輸入/輸出參數，指定的起始索引字符串從哪裏開始解析。如果解析成功，解析文本的索引更新錯誤，該指數是不變的錯誤索引設置爲發生錯誤的位置的索引。
返回

日期從解析，或空，如果有一個錯誤。
公共 對象 的parseObject （字符串字符串的ParsePosition位置）

日期：API等級1
解析一個從指定的字符串所指定的索引開始日期的位置。如果該字符串成功解析，那麼該指數的ParsePosition更新的指數解析文本。出現錯誤時，該指數保持不變，指數的ParsePosition的錯誤 設置發生錯誤的位置的索引。
默認情況下，解析是寬鬆：如果輸入的是不是在此對象的格式化方法使用的形式，但仍然可以解析爲一個日期，然後解析成功。客戶可能堅持嚴格遵守格式致電setLenient（假）。
參數

串 字符串解析。
位置 輸入/輸出參數，指定的起始索引 字符串從哪裏開始解析。如果解析成功，解析文本的索引更新錯誤，該指數是不變的錯誤索引設置爲發生錯誤的位置的索引。
返回

日期從解析，或空，如果有一個錯誤。
公共的無效 setCalendar （日曆 CAL）

日期：API等級1
設置此日期格式所使用的日曆。
參數

CAL 新的日曆。
公共無效 setLenient （布爾值）

日期：API等級1
指定解析日期/時間是否應寬鬆。與寬鬆的解析，解析器可能會使用啓發式解釋，不正是此對象的格式相匹配的輸入。輸入必須符合嚴格的解析，這個對象的格式。
參數

值 真正設置日曆是寬鬆的，虛假的 ，否則。
公共的無效 setNumberFormat （NumberFormat的格式）

日期：API等級1
設置此日期格式所使用的NumberFormat。
參數

格式 新的數字格式。
公共的無效 setTimeZone （TimeZone的時區）

日期：API等級1
此日期格式所使用的日曆設置時區。
參數

時區 新的時區。
日期和時間格式