语言

DateUtils.FormatDateRange 方法

定义

重载

名称 说明
FormatDateRange(Context, Int64, Int64, FormatStyleFlags)

根据本地约定设置日期或时间范围的格式。

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags)

根据本地约定设置日期或时间范围的格式。

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags, String)

根据本地约定设置日期或时间范围的格式。

FormatDateRange(Context, Int64, Int64, FormatStyleFlags)

根据本地约定设置日期或时间范围的格式。

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;JJI)Ljava/lang/String;", "")]
public static string? FormatDateRange(Android.Content.Context? context, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags);
[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;JJI)Ljava/lang/String;", "")>]
static member FormatDateRange : Android.Content.Context * int64 * int64 * Android.Text.Format.FormatStyleFlags -> string

参数

context
Context

仅当显示时间时,才需要上下文

startMillis
Int64

开始时间(UTC 毫秒)

endMillis
Int64

以 UTC 毫秒为单位的结束时间

flags
FormatStyleFlags

选项的位掩码请参阅 #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

返回

包含格式化日期/时间范围的字符串。

特性

注解

根据本地约定设置日期或时间范围的格式。

请注意,这是一种方便的方法。 使用它涉及到实时创建内部 java.util.Formatter 实例,在内存和时间方面成本稍高。 如果仅很少使用该方法,但如果您依赖此方法设置大量日期的格式,请考虑创建并重复使用自己的java.util.Formatter实例并使用该#formatDateRange(Context, long, long, int) formatDateRange版本java.util.Formatter。

适用于 . 的 android.text.format.DateUtils.formatDateRange(android.content.Context, long, long, int)Java 文档

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags)

根据本地约定设置日期或时间范围的格式。

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJI)Ljava/util/Formatter;", "")]
public static Java.Util.Formatter? FormatDateRange(Android.Content.Context? context, Java.Util.Formatter? formatter, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags);
[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJI)Ljava/util/Formatter;", "")>]
static member FormatDateRange : Android.Content.Context * Java.Util.Formatter * int64 * int64 * Android.Text.Format.FormatStyleFlags -> Java.Util.Formatter

参数

context
Context

仅当显示时间时,才需要上下文

formatter
Formatter

用于设置日期范围的格式化程序。 注意:除非希望结果累积,否则请确保对传递给 Formatter 构造函数的 StringBuilder 调用 setLength(0)。

startMillis
Int64

开始时间(UTC 毫秒)

endMillis
Int64

以 UTC 毫秒为单位的结束时间

flags
FormatStyleFlags

选项的位掩码请参阅 #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange

返回

包含格式化日期/时间范围的字符串。

特性

注解

根据本地约定设置日期或时间范围的格式。

请注意,这是在本地时区中设置日期或时间范围的便利方法。 如果要指定时区,请使用 #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange。

适用于 . 的 android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int)Java 文档

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于

FormatDateRange(Context, Formatter, Int64, Int64, FormatStyleFlags, String)

根据本地约定设置日期或时间范围的格式。

[Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJILjava/lang/String;)Ljava/util/Formatter;", "")]
public static Java.Util.Formatter? FormatDateRange(Android.Content.Context? context, Java.Util.Formatter? formatter, long startMillis, long endMillis, Android.Text.Format.FormatStyleFlags flags, string? timeZone);
[<Android.Runtime.Register("formatDateRange", "(Landroid/content/Context;Ljava/util/Formatter;JJILjava/lang/String;)Ljava/util/Formatter;", "")>]
static member FormatDateRange : Android.Content.Context * Java.Util.Formatter * int64 * int64 * Android.Text.Format.FormatStyleFlags * string -> Java.Util.Formatter

参数

context
Context

仅当显示时间时,才需要上下文

formatter
Formatter

用于设置日期范围的格式化程序。 注意:除非希望结果累积,否则请确保对传递给 Formatter 构造函数的 StringBuilder 调用 setLength(0)。

startMillis
Int64

开始时间(UTC 毫秒)

endMillis
Int64

以 UTC 毫秒为单位的结束时间

flags
FormatStyleFlags

选项的位掩码

timeZone
String

要在其中计算字符串的时区的 ID。 将 null 用于本地或正在使用FORMAT_UTC标志。

返回

格式化日期/时间范围追加到字符串缓冲区的格式化程序。

特性

注解

根据本地约定设置日期或时间范围的格式。

示例输出字符串(这些示例中的日期格式使用美国日期格式约定显示,但可能会根据本地设置而更改):ul<li 10:15am>/li li<><3:00pm - 4:00pm>/li<><li 3pm - 4pm>/li<><li 3PM - 4PM>/li<><li 08:00 - 17:00>/li li Oct 9</><>li<><li Tue, 10月9>日/李<>丽<10月9日,><> 2007</li li><>Oct 9 - 10</li li><>Oct 9 - 10, 2007</li li><>Oct 28 - 2007/li li<><Dec 31, 2007> - Jan 1, 2008</li li><>Oct 9, 8:00am - Oct 10, 5:00pm</li li><>12/31/2007 - 01/01/2008</li></ul>

标志参数是以下列表中的选项的位掩码:

<ul>li FORMAT_SHOW_TIME/li li FORMAT_SHOW_WEEKDAY</li><><><FORMAT_SHOW_YEAR/><>li li FORMAT_SHOW_DATE</><>li li FORMAT_NO_MONTH_DAY</><><li li FORMAT_12HOUR>/<><>li li FORMAT_24HOUR/li li FORMAT_CAP_AMPM</><><><>li li FORMAT_NO_NOON/li li FORMAT_CAP_NOON</li><><><><li><FORMAT_NO_MIDNIGHT/李丽>FORMAT_CAP_MIDNIGHT</李><><>丽FORMAT_UTC</李><><FORMAT_ABBREV_TIME/><>李丽FORMAT_ABBREV_WEEKDAY</李丽FORMAT_ABBREV_MONTH/><><李><><丽FORMAT_ABBREV_ALL/李丽FORMAT_NUMERIC_DATE>/li<><></ul>

如果设置了FORMAT_SHOW_TIME,时间会显示为日期范围的一部分。 如果开始时间和结束时间相同,则只显示开始时间。

如果设置了FORMAT_SHOW_WEEKDAY,则显示工作日。

如果设置了FORMAT_SHOW_YEAR,则始终显示年份。 如果未设置FORMAT_SHOW_YEAR,则仅当年份与当前年份不同或开始日期和结束日期在不同的年份时,才会显示该年份。

通常,除非开始和结束日期相同,否则将显示日期。 如果设置了FORMAT_SHOW_DATE,则始终显示日期,即使在同一天范围内也是如此。

如果设置了FORMAT_NO_MONTH_DAY,则如果显示日期,则只显示月份名称,而不是月份的日期。 例如,“2008 年 1 月”而不是“2008 年 1 月 6 日至 12 日”。

如果设置了FORMAT_CAP_AMPM并使用 12 小时时间,则会大写“AM”和“PM”。 不应使用此标志,因为在某些区域设置中,这些术语不能大写,而且在许多情况下,即使可能这样做,也毫无意义。

如果设置了FORMAT_NO_NOON并使用 12 小时时间,则显示“下午 12 点”而不是“中午”。

如果设置了FORMAT_CAP_NOON并使用 12 小时时间,则显示“中午”而不是“中午”。 你可能不应该使用此标志,因为在许多区域设置中,大写术语是没有意义的。

如果设置了FORMAT_NO_MIDNIGHT并使用 12 小时时间,则显示“上午 12 点”而不是“午夜”。

如果设置了FORMAT_CAP_MIDNIGHT并使用 12 小时时间,则会显示“午夜”而不是“午夜”。 你可能不应该使用此标志,因为在许多区域设置中,大写术语是没有意义的。

如果设置了FORMAT_12HOUR并显示时间,则时间以 12 小时时间格式显示。 通常不应设置此设置。 相反,请根据系统设置自动选择时间格式。 如果同时设置了FORMAT_12HOUR和FORMAT_24HOUR,则FORMAT_24HOUR优先。

如果设置了FORMAT_24HOUR并显示时间,则时间以 24 小时时间格式显示。 通常不应设置此设置。 相反,请根据系统设置自动选择时间格式。 如果同时设置了FORMAT_12HOUR和FORMAT_24HOUR,则FORMAT_24HOUR优先。

如果设置了FORMAT_UTC,则除非指定时区,否则 UTC 时区用于开始和结束毫秒。 如果指定了时区,则无论FORMAT_UTC标志如何,都将使用它。

如果设置了FORMAT_ABBREV_TIME并使用了 12 小时的时间格式,则开始和结束时间(如果已显示),如果未显示分钟数(如果为零)。 例如,时间将缩写为“下午 3:00”,而不是“下午 3:00”。

如果设置了FORMAT_ABBREV_WEEKDAY,则工作日(如果显示)缩写为 3 个字母字符串。

如果设置了FORMAT_ABBREV_MONTH,则月份(如果显示)缩写为 3 个字母字符串。

如果设置了FORMAT_ABBREV_ALL,则工作日和月份(如果显示)缩写为 3 个字母字符串。

如果设置了FORMAT_NUMERIC_DATE,则日期以数字格式显示,而不是使用月份的名称。 例如,“2008/12/31”而不是“2008 年 12 月 31 日”。

如果结束日期在一天开始时间上午 12:00 结束,则会在两种情况下将其格式化为前一天的结束时间: <ul><li>对于单日事件。 这会导致“晚上 8 点 - 午夜” 而不是 “11 月 10 日, 晚上 8 点 - 11 月 11 日上午 12 点”。</li li><>当时间未显示时。 这会导致事件“11月10日至11日”,开始日期为11月10日,11月12日结束日期为00:00。</li></ul>

适用于 . 的 android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int, java.lang.String)Java 文档

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于