DateFormat 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
DateFormat 是日期/时间格式的抽象类，以独立于语言的方式格式化和分析日期或时间。
[Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)]
public abstract class DateFormat : Java.Text._Format[<Android.Runtime.Register("java/text/DateFormat", DoNotGenerateAcw=true)>]
type DateFormat = class
inherit _Format- 继承
- 派生
- 属性
注解
DateFormat 是日期/时间格式的抽象类，以独立于语言的方式格式化和分析日期或时间。 日期/时间格式子类（例如 SimpleDateFormat，允许格式设置（即 date → text）、分析（文本 → 日期）和规范化。 日期表示为对象 Date 或自 1970 年 1 月 1 日格林尼治标准时间 00：00：00 以来的毫秒。
DateFormat 提供了许多类方法，用于根据默认格式设置或给定的区域设置和许多格式样式获取默认日期/时间格式化程序。 格式设置样式包括#FULL、#LONG和#MEDIUM#SHORT。 方法说明中提供了使用这些样式的更多详细信息和示例。
DateFormat 帮助你设置任何区域设置的格式和分析日期。 您的代码可以完全独立于月、星期几甚至日历格式的区域设置约定：农历与太阳。
若要设置当前区域设置的日期格式，请使用静态工厂方法之一： <blockquote>
{@code
myString = DateFormat.getDateInstance().format(myDate);
}
</blockquote>
如果要设置多个日期的格式，则获取格式并多次使用它更高效，以便系统不必多次提取有关本地语言和国家/地区约定的信息。 <blockquote>
{@code
DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
output.println(df.format(myDate[i]) + "; ");
}
}
</blockquote>
若要设置其他区域设置的日期格式，请在调用中 #getDateInstance(int, Locale) getDateInstance()指定该日期。
<blockquote>
{@code
DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);
}
</blockquote>
还可以使用 DateFormat 进行分析。 <blockquote>
{@code
myDate = df.parse(myString);
}
</blockquote>
用于 getDateInstance 获取该国家/地区的正常日期格式。 还有其他可用的静态工厂方法。 用于 getTimeInstance 获取国家/地区的时间格式。 用于 getDateTimeInstance 获取日期和时间格式。 可以将不同的选项传递给这些工厂方法，以控制结果的长度;从 #SHORT 到 #MEDIUM 到 #LONG#FULL。 确切的结果取决于区域设置，但一般情况下：ul li#SHORT 是完全数字的，如12.13.52或<3:30pm李>#MEDIUM是更长的，如<Jan 12, 1952李>#LONG是更长的，如January 12, 1952或3:30:32pm<李>#FULL是相当完全指定的，如。Tuesday, April 12, 1952 AD or 3:30:42pm PST>><<
</ul>
如果需要，还可以设置格式的时区。 如果希望更好地控制格式或分析（或者希望为用户提供更多控制），可以尝试将你从工厂方法转换为 DateFormat a SimpleDateFormat。 这将适用于大多数国家/地区：只是记得把它放在一个 try 块， 以防你遇到一个不寻常的块。
还可以使用分析和格式方法ParsePosition的形式，并允许FieldPosition你<><>逐步分析字符串片段。
<li>对齐任何特定字段，或找出它用于在屏幕上选择的位置。
</ul>
<h2>“synchronization”>Synchronization</h2>
日期格式未同步。 建议为每个线程创建单独的格式实例。 如果多个线程同时访问格式，则必须在外部同步。
在 1.1 中添加。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| 名称 | 说明 |
|---|---|
| DateFormat() |
创建新的日期格式。 |
| DateFormat(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
字段
| 名称 | 说明 |
|---|---|
| AmPmField |
用于AM_PM字段对齐的有用常量。 |
| DateField |
DATE 字段对齐的有用常量。 |
| DayOfWeekField |
用于DAY_OF_WEEK字段对齐的有用常量。 |
| DayOfWeekInMonthField |
用于DAY_OF_WEEK_IN_MONTH字段对齐的有用常量。 |
| DayOfYearField |
用于DAY_OF_YEAR字段对齐的有用常量。 |
| Default |
默认样式模式的常量。 |
| EraField |
用于 ERA 字段对齐的有用常量。 |
| Full |
完整样式模式的常量。 |
| Hour0Field |
用于从零开始的 HOUR 字段对齐的有用常量。 |
| Hour1Field |
用于基于一个的 HOUR 字段对齐的有用常量。 |
| HourOfDay0Field |
用于从零开始的HOUR_OF_DAY字段对齐的有用常量。 |
| HourOfDay1Field |
用于基于一HOUR_OF_DAY字段对齐的有用常量。 |
| Long |
长样式模式的常量。 |
| Medium |
中等样式模式的常量。 |
| MillisecondField |
用于毫秒字段对齐的有用常量。 |
| MinuteField |
用于 MINUTE 字段对齐的有用常量。 |
| MonthField |
月份字段对齐的有用常量。 |
| SecondField |
SECOND 字段对齐的有用常量。 |
| Short |
短样式模式的常量。 |
| TimezoneField |
TIMEZONE 字段对齐的有用常量。 |
| WeekOfMonthField |
用于WEEK_OF_MONTH字段对齐的有用常量。 |
| WeekOfYearField |
用于WEEK_OF_YEAR字段对齐的有用常量。 |
| YearField |
YEAR 字段对齐的有用常量。 |
属性
| 名称 | 说明 |
|---|---|
| Calendar |
获取与此日期/时间格式化程序关联的日历。 - 或 - 设置此日期格式要使用的日历。 |
| Class |
返回此 |
| DateInstance |
获取具有默认 |
| DateTimeInstance |
获取具有默认 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| Instance |
获取默认日期/时间格式化程序，该格式化程序使用日期和时间的 SHORT 样式。 |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| Lenient |
告知日期/时间分析是否宽松。 - 或 - 指定日期/时间分析是否宽松。 |
| NumberFormat |
获取此日期/时间格式化程序用于格式化和分析时间的数字格式化程序。 - 或 - 允许设置数字格式化程序。 |
| PeerReference |
|
| ThresholdClass |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 |
| TimeInstance |
获取具有默认 |
| TimeZone |
获取时区。 - 或 - 设置此 |
方法
| 名称 | 说明 |
|---|---|
| Clone() |
创建并返回此对象的副本。 (继承自 _Format) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| Format(Date, StringBuffer, FieldPosition) |
将 a |
| Format(Date) |
将 a |
| Format(Object, StringBuffer, FieldPosition) |
将给定 |
| Format(Object) |
设置对象的格式以生成字符串。 (继承自 _Format) |
| FormatToCharacterIterator(Object) |
设置生成 . 的对象 |
| GetAvailableLocales() |
返回此类方法可以返回本地化实例的所有区域设置 |
| GetDateInstance(Int32, Locale) |
获取具有给定区域设置的给定格式样式的日期格式化程序。 |
| GetDateInstance(Int32) |
获取具有默认 |
| GetDateTimeInstance(Int32, Int32, Locale) |
获取具有给定区域设置的给定格式样式的日期/时间格式化程序。 |
| GetDateTimeInstance(Int32, Int32) |
获取具有默认区域设置的给定日期和时间格式样式的 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetTimeInstance(Int32, Locale) |
获取具有给定区域设置的给定格式样式的时间格式化程序。 |
| GetTimeInstance(Int32) |
获取具有默认 |
| JavaFinalize() |
当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Parse(String, ParsePosition) |
根据给定分析位置分析日期/时间字符串。 |
| Parse(String) |
分析给定字符串开头的文本以生成日期。 |
| ParseObject(String, ParsePosition) |
分析字符串中的文本以生成一个 |
| ParseObject(String) |
分析给定字符串开头的文本以生成对象。 (继承自 _Format) |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| ToArray<T>() |
|
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
|
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |