DateUtils.FormatDateRange Méthode

[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

Paramètres

Retours

chaîne contenant l’intervalle de date/heure mis en forme.

Attributs

RegisterAttribute

Remarques

Met en forme une date ou une plage horaire en fonction des conventions locales.

Notez qu’il s’agit d’une méthode pratique. L’utilisation implique la création d’une instance interne java.util.Formatter à la volée, ce qui est quelque peu coûteux en termes de mémoire et de temps. Cela est probablement acceptable si vous utilisez la méthode uniquement rarement, mais si vous vous en appuyez sur celui-ci pour mettre en forme un grand nombre de dates, envisagez de créer et de réutiliser votre propre java.util.Formatter instance et d’utiliser la version de celle-ci #formatDateRange(Context, long, long, int) formatDateRange prend un java.util.Formatter.

Java documentation pour android.text.format.DateUtils.formatDateRange(android.content.Context, long, long, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[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

Paramètres

Retours

chaîne contenant l’intervalle de date/heure mis en forme.

Attributs

RegisterAttribute

Remarques

Met en forme une date ou une plage horaire en fonction des conventions locales.

Notez qu’il s’agit d’une méthode pratique pour mettre en forme l’intervalle de date ou d’heure dans le fuseau horaire local. Si vous souhaitez spécifier le fuseau horaire, utilisez #formatDateRange(Context, Formatter, long, long, int, String) formatDateRange.

Java documentation pour android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[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

Paramètres

Retours

le formateur avec l’intervalle de date/heure mis en forme ajouté à la mémoire tampon de chaîne.

Attributs

RegisterAttribute

Remarques

Met en forme une date ou une plage horaire en fonction des conventions locales.

Exemples de chaînes de sortie (formats de date dans ces exemples sont présentés à l’aide de la convention de format de date américaine, mais qui peuvent changer en fonction des paramètres locaux) : ul>li 10:15am</li li><>3:00 /17:00</li li>3pm - 4PM><><</><>li 08:00 - 17:00</li<<>>li>9</><>li Tue, 9< octobre/li li><>9 octobre,><< 2007</li li><>9 - 10</li li<>>9 - 10, 2007</li li<>>28 octobre - 3 novembre 2007</li<>li>dec 31, 2007 - 1er janvier 2008</li li<>>9, 8:00 - 10 octobre 10, 5:00pm</li li><>12/31/2007 - 01/01/2008</li></ul>

L’argument indicateurs est un masque de bits d’options dans la liste suivante :

<ul><li>FORMAT_SHOW_TIME</><li FORMAT_SHOW_WEEKDAY></><li 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_NO_NOON/li<>li>FORMAT_CAP_NOON</li><><><li><FORMAT_NO_MIDNIGHT/><li li>FORMAT_CAP_MIDNIGHT</li><li>FORMAT_UTC</li<>li>FORMAT_ABBREV_TIME</><li li>FORMAT_ABBREV_WEEKDAY</><>li li FORMAT_ABBREV_MONTH</li<>li>FORMAT_ABBREV_ALL</li><li>FORMAT_NUMERIC_DATE</li></ul>

Si FORMAT_SHOW_TIME est définie, l’heure est affichée dans le cadre de la plage de dates. Si l’heure de début et de fin est identique, l’heure de début est affichée.

Si FORMAT_SHOW_WEEKDAY est définie, le jour de la semaine s’affiche.

Si FORMAT_SHOW_YEAR est définie, l’année est toujours affichée. Si FORMAT_SHOW_YEAR n’est pas définie, l’année est affichée uniquement si elle est différente de l’année en cours ou si les dates de début et de fin tombent sur des années différentes.

Normalement, la date est affichée, sauf si le jour de début et de fin est le même. Si FORMAT_SHOW_DATE est définie, la date est toujours affichée, même pour les plages de jour mêmes.

Si FORMAT_NO_MONTH_DAY est définie, si la date est affichée, le nom du mois est affiché, et non le jour du mois. Par exemple, « Janvier 2008 » au lieu de « 6 - 12 janvier 2008 ».

Si FORMAT_CAP_AMPM est définie et que l’heure de 12 heures est utilisée, les valeurs « AM » et « PM » sont majuscules. Vous ne devez pas utiliser cet indicateur, car dans certains paramètres régionaux, ces termes ne peuvent pas être capitalisés, et dans beaucoup d’autres, il n’est pas judicieux de le faire même si c’est possible.

Si FORMAT_NO_NOON est définie et que l’heure de 12 heures est utilisée, « 12pm » est affichée au lieu de « midi ».

Si FORMAT_CAP_NOON est définie et que l’heure de 12 heures est utilisée, « Noon » est affiché au lieu de « midi ». Vous ne devez probablement pas utiliser cet indicateur, car dans de nombreux paramètres régionaux, il n’est pas judicieux de mettre en majuscule le terme.

Si FORMAT_NO_MIDNIGHT est définie et que l’heure de 12 heures est utilisée, « 12 h » est affichée au lieu de « minuit ».

Si FORMAT_CAP_MIDNIGHT est définie et que l’heure de 12 heures est utilisée, « Minuit » est affiché au lieu de « minuit ». Vous ne devez probablement pas utiliser cet indicateur, car dans de nombreux paramètres régionaux, il n’est pas judicieux de mettre en majuscule le terme.

Si FORMAT_12HOUR est définie et que l’heure est affichée, l’heure est affichée dans le format d’heure de 12 heures. Vous ne devez pas définir cela normalement. Au lieu de cela, laissez le format de temps être choisi automatiquement en fonction des paramètres système. Si les FORMAT_12HOUR et les FORMAT_24HOUR sont définis, FORMAT_24HOUR est prioritaire.

Si FORMAT_24HOUR est définie et que l’heure est affichée, l’heure est affichée dans le format d’heure de 24 heures. Vous ne devez pas définir cela normalement. Au lieu de cela, laissez le format de temps être choisi automatiquement en fonction des paramètres système. Si les FORMAT_12HOUR et les FORMAT_24HOUR sont définis, FORMAT_24HOUR est prioritaire.

Si FORMAT_UTC est défini, le fuseau horaire UTC est utilisé pour les millisecondes de début et de fin, sauf si un fuseau horaire est spécifié. Si un fuseau horaire est spécifié, il sera utilisé quel que soit l’indicateur de FORMAT_UTC.

Si FORMAT_ABBREV_TIME est définie et que le format d’heure de 12 heures est utilisé, les heures de début et de fin (si affichées) sont abrégées en n’affichant pas les minutes si elles sont égales à zéro. Par exemple, au lieu de « 3 h 00 », l’heure serait abrégée en « 3 h ».

Si FORMAT_ABBREV_WEEKDAY est définie, le jour de la semaine (s’il est affiché) est abrégé en chaîne de 3 lettres.

Si FORMAT_ABBREV_MONTH est définie, le mois (s’il est affiché) est abrégé en chaîne de 3 lettres.

Si FORMAT_ABBREV_ALL est défini, le jour de la semaine et le mois (s’il est indiqué) sont abrégés en chaînes de 3 lettres.

Si FORMAT_NUMERIC_DATE est définie, la date est affichée au format numérique au lieu d’utiliser le nom du mois. Par exemple, « 12/31/2008 » au lieu du « 31 décembre 2008 ».

Si la date de fin se termine à 12h00 au début d’un jour, elle est mise en forme comme fin du jour précédent dans deux scénarios : <ul><li>Pour les événements d’un jour unique. Cela se traduit par « 8h - minuit » au lieu de « 10 novembre, 8h - 11 novembre 12h ».</li li><>Lorsque l’heure n’est pas affichée. Cela aboutit à « 10 - 11 novembre » pour un événement avec une date de début du 10 novembre et une date de fin du 12 novembre à 00:00.</li></ul>

Java documentation pour android.text.format.DateUtils.formatDateRange(android.content.Context, java.util.Formatter, long, long, int, java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.