DateIntervalFormat Classe

Definizione

[Android.Runtime.Register("android/icu/text/DateIntervalFormat", ApiSince=24, DoNotGenerateAcw=true)]
public class DateIntervalFormat : Android.Icu.Text.UFormat

[<Android.Runtime.Register("android/icu/text/DateIntervalFormat", ApiSince=24, DoNotGenerateAcw=true)>]
type DateIntervalFormat = class
    inherit UFormat

Ereditarietà

Object

Object

_Format

UFormat

DateIntervalFormat

Attributi

RegisterAttribute

Commenti

DateIntervalFormat è una classe per la formattazione e l'analisi degli intervalli di data in modo indipendente dalla lingua. È supportata solo la formattazione. L'analisi non è supportata.

Intervallo di date indica da una data a un'altra, ad esempio da "Jan 11, 2008" a "Jan 18, 2008". È stata introdotta la classe DateInterval per rappresentarla. DateInterval è una coppia di UDate, ovvero i millisecondi standard dalle 24:00 GMT, 1 gennaio 1970.

DateIntervalFormat formatta un oggetto DateInterval in testo il più compatto possibile. Ad esempio, il formato dell'intervallo di date compreso tra "11 gennaio 2008" e "18 gennaio". 2008" è "11-18 gennaio 2008" per l'inglese. Analizza il testo in DateInterval, anche se inizialmente l'analisi non è supportata.

Non esistono informazioni strutturali nei modelli di data e ora. Per eventuali segni di punteggiatura e valori letterali stringa all'interno di un criterio di data e ora, non sappiamo se si tratta solo di un separatore, di un prefisso o di un suffisso. Senza tali informazioni, pertanto, è difficile generare un modello secondario (o super pattern) per algoritmo. Pertanto, la formattazione di un valore DateInterval è basata su criteri. È molto simile alla formattazione in SimpleDateFormat. Viene introdotta la classe DateIntervalInfo per salvare i modelli di intervallo di data, in modo simile al modello di data e ora in SimpleDateFormat.

Logicamente, i modelli di intervallo sono mapping da (scheletro, the_largest_different_calendar_field) a (date_interval_pattern).

Uno scheletro <ol><li> mantiene solo la lettera di motivo campo e ignora tutte le altre parti in un modello, ad esempio spazio, punteggiatura e valori letterali stringa. <li> nasconde l'ordine dei campi. <li> potrebbe nascondere la lunghezza della lettera del modello di un campo.

Per i campi di calendario non di cifre, la lunghezza della lettera di modello è importante, ad esempio MMM, MMMM e MMMMM; EEE e EEEE e viene rispettata la lunghezza della lettera di motivo del campo.

Per i campi del calendario delle cifre, ad esempio M o MM, d o dd, yy o aa, la lunghezza del criterio di campo viene ignorata e la corrispondenza migliore, definita nei modelli di data e ora, verrà restituita senza rispettare la lunghezza della lettera del criterio di campo nello scheletro. </ol>

I campi del calendario supportati per la formattazione dell'intervallo sono: anno, mese, data, giorno della settimana, am-pm, ora, ora, ora del giorno, minuto e secondo (anche se attualmente non sono disponibili dati intervalFormat specifici per gli scheletri con secondi). Tali campi di calendario possono essere definiti nell'ordine seguente: anno > month > date > ora (in giorno) > minute > secondo

I campi di calendario più grandi tra 2 calendari sono il primo campo calendario diverso nell'ordine precedente.

Ad esempio, i campi di calendario più grandi tra "10 gennaio 2007" e "Febbraio 20, 2008" sono anno.

Per altri campi del calendario, la formattazione dell'intervallo compatto non è supportata. E il formato intervallo verrà eseguito il fallback ai modelli di fallback, che è principalmente "{date0} - {date1}".

Esiste un set di stringhe di scheletro statico predefinite in DateFormat. Esistono modelli di intervallo predefiniti per tali scheletri predefiniti nei file di risorse delle impostazioni locali. Ad esempio, per uno scheletro YEAR_ABBR_MONTH_DAY, che è "yMMMd", in en_US, se il campo di calendario più grande tra date1 e date2 è "year", il modello di intervallo di date è "MMM d, aaaa - MMM d, a", ad esempio "Jan 10, 2007 - Jan 10, 2008". Se il campo di calendario più grande tra date1 e date2 è "month", il modello di intervallo di date è "MMM d - MMM d, aaaa", ad esempio "Jan 10 - Feb 10, 2007". Se il campo di calendario più grande tra date1 e date2 è "day", il modello di intervallo di date è ""MMM d-d, aaaaa", ad esempio "10-20 gennaio 2007".

Per lo scheletro di data, i modelli di intervallo in cui anno o mese o data sono diversi sono definiti nei file di risorse. Per lo scheletro di tempo, i modelli di intervallo in cui am/pm o ora o ora sono diversi sono definiti nei file di risorse.

Se uno scheletro non viene trovato in DateIntervalInfo delle impostazioni locali, il che significa che i modelli di intervallo per lo scheletro non sono definiti nel file di risorse, il modello di intervallo tornerà al modello di "fallback" dell'intervallo definito nel file di risorse. Se l'intervallo "fallback" non è definito, il fallback predefinito è "{date0} - {data1}".

Per la combinazione di data e ora, La regola per i modelli di intervallo genearte sono: <ol><li> quando l'anno, il mese o il giorno differisce, fallback al modello di intervallo di fallback, che è principalmente la concatenazione delle due espressioni originali con un separatore tra, ad esempio, il modello di intervallo da "10 gennaio 2007 10:10" a "11 gennaio 2007 10:10" è "Jan 10, 2007 10:10 - 11 gennaio 2007 10:10" <li> in caso contrario, presentare la data seguita dall'espressione intervallo per l'ora. Ad esempio, il modello di intervallo da "Jan 10, 2007 10:10 am" a "Jan 10, 2007 11:10am" è "Jan 10, 2007 10:10 am - 11:10am" </ol>

Se due date sono uguali, il modello di intervallo è il modello a data singola. Ad esempio, il criterio di intervallo compreso tra "10 gennaio 2007" e "10 gennaio 2007" è "10 gennaio 2007".

Oppure se i campi che presentano tra 2 date hanno esattamente gli stessi valori, il modello di intervallo è il modello di data singolo. Ad esempio, se l'utente richiede solo anno e mese, il modello di intervallo compreso tra "Jan 10, 2007" e "Jan 20, 2007" è "Jan 2007".

DateIntervalFormat richiede le informazioni seguenti per la formattazione corretta: fuso orario, tipo di calendario, motivo, simboli di formato data e modelli di intervallo di date. Può essere creata un'istanza in diversi modi: <ol><li> crea un'istanza usando le impostazioni locali predefinite o specificate più la struttura specificata. Gli utenti sono invitati a creare il formattatore dell'intervallo di date in questo modo e a usare le macro di struttura predefinite, ad esempio YEAR_NUM_MONTH, che è costituito dai campi del calendario e dallo stile del formato. </li><crea> un'istanza usando impostazioni locali predefinite o specificate più uno scheletro specificato più un dato DateIntervalInfo. Questo metodo factory è destinato a utenti potenti che vogliono fornire modelli di intervallo personalizzati. Le impostazioni locali forniscono informazioni sui simboli di fuso orario, calendario e formato. Lo scheletro più locale fornisce informazioni complete sul modello. DateIntervalInfo fornisce i modelli di intervallo di date. </li></ol>

Per la lettera del modello di campo del calendario, ad esempio G, y, M, d, a, h, H, m, s e così via. DateIntervalFormat usa la stessa sintassi del formato DateTime.

Esempio di codice: utilizzo generale

// the date interval object which the DateIntervalFormat formats on
              // and parses into
              DateInterval dtInterval = new DateInterval(1000*3600*24L, 1000*3600*24*2L);
              DateIntervalFormat dtIntervalFmt = DateIntervalFormat.getInstance(
                      DateFormat.YEAR_MONTH_DAY, new Locale("en", "GB", ""));
              StringBuffer result = new StringBuffer("");
              FieldPosition pos = new FieldPosition(-1);
              // formatting
              dtIntervalFmt.format(dtInterval, result, pos);
              assertEquals("interval", "1–2 January 1970", result.toString());

Esempio di codice: per utenti potenti che vogliono usare il proprio modello di intervallo

import android.icu.text.DateIntervalInfo;
                import android.icu.text.DateIntervalFormat;
                ....................

                // Get DateIntervalFormat instance using default locale
                DateIntervalFormat dtitvfmt = DateIntervalFormat.getInstance(YEAR_MONTH_DAY);

                // Create an empty DateIntervalInfo object, which does not have any interval patterns inside.
                dtitvinf = new DateIntervalInfo();

                // a series of set interval patterns.
                // Only ERA, YEAR, MONTH, DATE,  DAY_OF_MONTH, DAY_OF_WEEK, AM_PM,  HOUR, HOUR_OF_DAY,
                MINUTE, SECOND and MILLISECOND are supported.
                dtitvinf.setIntervalPattern("yMMMd", Calendar.YEAR, "'y ~ y'");
                dtitvinf.setIntervalPattern("yMMMd", Calendar.MONTH, "yyyy 'diff' MMM d - MMM d");
                dtitvinf.setIntervalPattern("yMMMd", Calendar.DATE, "yyyy MMM d ~ d");
                dtitvinf.setIntervalPattern("yMMMd", Calendar.HOUR_OF_DAY, "yyyy MMM d HH:mm ~ HH:mm");

                // Set fallback interval pattern. Fallback pattern is used when interval pattern is not found.
                // If the fall-back pattern is not set,  falls back to {date0} - {date1} if interval pattern is not found.
                dtitvinf.setFallbackIntervalPattern("{0} - {1}");

                // Set above DateIntervalInfo object as the interval patterns of date interval formatter
                dtitvfmt.setDateIntervalInfo(dtitvinf);

                // Prepare to format
                pos = new FieldPosition(0);
                str = new StringBuffer("");

                // The 2 calendars should be equivalent, otherwise,  IllegalArgumentException will be thrown by format()
                Calendar fromCalendar = (Calendar) dtfmt.getCalendar().clone();
                Calendar toCalendar = (Calendar) dtfmt.getCalendar().clone();
                fromCalendar.setTimeInMillis(....);
                toCalendar.setTimeInMillis(...);

                //Formatting given 2 calendars
                dtitvfmt.format(fromCalendar, toCalendar, str, pos);

<h3>Synchronization</h3>

I metodi di formato di DateIntervalFormat possono essere usati simultaneamente da più thread. Le funzioni che modificano lo stato di un oggetto DateIntervalFormat (setter) non possono essere usate simultaneamente con altre funzioni.

per android.icu.text.DateIntervalFormat.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.