ZonedDateTime Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio 2007-12-03T10:15:30+01:00 Europe/Paris.
[Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class ZonedDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoZonedDateTime[<Android.Runtime.Register("java/time/ZonedDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type ZonedDateTime = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IChronoZonedDateTime
interface IComparable
interface ITemporal
interface ITemporalAccessor- Ereditarietà
- Attributi
- Implementazioni
Commenti
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio 2007-12-03T10:15:30+01:00 Europe/Paris.
ZonedDateTime è una rappresentazione non modificabile di una data e ora con un fuso orario. Questa classe archivia tutti i campi di data e ora, a una precisione di nanosecondi e a un fuso orario, con un offset di zona usato per gestire orari di data e ora locali ambigui. Ad esempio, il valore "2 ottobre 2007 alle 13:45.30.123456789 +02:00 nel fuso orario Europa/Parigi" può essere archiviato in un oggetto ZonedDateTime.
Questa classe gestisce la conversione dalla riga temporale locale di LocalDateTime alla riga temporale immediata di Instant. La differenza tra le due righe temporali è l'offset rispetto all'ora UTC/Greenwich, rappresentato da un oggetto ZoneOffset.
La conversione tra le due righe temporali comporta il calcolo dell'offset utilizzando l'oggetto ZoneRules rules a cui si accede da ZoneId. Ottenere l'offset per un istante è semplice, perché esiste esattamente un offset valido per ogni istante. Al contrario, ottenere l'offset per una data e ora locale non è semplice. Esistono tre casi: <ul><li>Normal, con un offset valido. Per la maggior parte dell'anno, si applica il caso normale, in cui è presente un unico offset valido per la data e l'ora locale.</li><li>Gap, con zero offset validi. Questo è quando gli orologi saltano in avanti in genere a causa del cambio di ora legale primavera da "inverno" a "estate". In un gap sono presenti valori di data e ora locali senza offset valido.</li><li>Overlap, con due offset validi. Questo è quando gli orologi sono tornati in genere a causa del cambio di ora legale autunno da "estate" a "inverno". In una sovrapposizione sono presenti valori di data e ora locali con due offset validi.</li></ul>
Qualsiasi metodo che converte direttamente o in modo implicito da una data e ora locale a un istante ottenendo l'offset può essere complicato.
Per Gap, la strategia generale è che se la data e l'ora locale rientra nel mezzo di un gap, l'ora di data con zona risultante avrà un data/ora locale spostata in avanti per la lunghezza del gap, con conseguente data-ora nell'offset successivo, in genere "estate".
Per le sovrapposizioni, la strategia generale è che se l'ora di data locale rientra al centro di una sovrapposizione, l'offset precedente verrà mantenuto. Se non è presente alcun offset precedente o l'offset precedente non è valido, viene utilizzato l'offset precedente, in genere l'ora "estate". Due metodi aggiuntivi e #withEarlierOffsetAtOverlap()#withLaterOffsetAtOverlap(), consentono di gestire il caso di una sovrapposizione.
In termini di progettazione, questa classe deve essere considerata principalmente come la combinazione di un LocalDateTime oggetto e un oggetto ZoneId.
ZoneOffset è un elemento essenziale, ma secondario, usato per garantire che la classe rappresenti un istante, soprattutto durante una sovrapposizione dell'ora legale.
Aggiunta nella versione 1.8.
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.
Proprietà
| Nome | Descrizione |
|---|---|
| Class |
Restituisce la classe di runtime di questo |
| DayOfMonth |
Ottiene il campo giorno del mese. |
| DayOfWeek |
Ottiene il campo day-of-week, ovvero un oggetto DayOfWeek di enumerazione. |
| DayOfYear |
Ottiene il campo giorno dell'anno. |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| Hour |
Ottiene il campo hour-of-day. |
| JniIdentityHashCode |
Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| JniManagedPeerState |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| JniPeerMembers |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Minute |
Ottiene il campo minuto dell'ora. |
| Month |
Ottiene il campo month-of-year utilizzando l'enumerazione Month. |
| MonthValue |
Ottiene il campo mensile dell'anno compreso tra 1 e 12. |
| Nano |
Ottiene il campo nano-di secondo. |
| Offset |
Ottiene l'offset di zona, ad esempio '+01:00'. |
| PeerReference |
Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object) |
| Second |
Ottiene il campo del secondo minuto. |
| ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object) |
| ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. (Ereditato da Object) |
| Year |
Ottiene il campo year. |
| Zone |
Ottiene il fuso orario, ad esempio "Europa/Parigi". |
Metodi
| Nome | Descrizione |
|---|---|
| Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
| CompareTo(Object) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Dispose() |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Dispose(Boolean) |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| DisposeUnlessReferenced() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Equals(Object) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| Format(DateTimeFormatter) |
Formatta questa data/ora utilizzando il formattatore specificato. |
| From(ITemporalAccessor) |
Ottiene un'istanza di ZonedDateTime da un oggetto temporale. |
| Get(ITemporalField) |
Ottiene il valore del campo specificato da questa data e ora come valore int. |
| GetHashCode() |
Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object) |
| GetLong(ITemporalField) |
Ottiene il valore del campo specificato da questa data e ora come long. |
| IsSupported(ITemporalField) |
Controlla se il campo specificato è supportato. |
| IsSupported(ITemporalUnit) |
Controlla se l'unità specificata è supportata. |
| JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
| Minus(Int64, ITemporalUnit) |
Restituisce una copia di questa data e ora con la quantità specificata sottratta. |
| Minus(ITemporalAmount) |
Restituisce una copia di questa data e ora con la quantità specificata sottratta. |
| MinusDays(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di giorni sottratti. |
| MinusHours(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di ore sottratte. |
| MinusMinutes(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di minuti sottratti. |
| MinusMonths(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di mesi sottratti. |
| MinusNanos(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di nanosecondi sottratti. |
| MinusSeconds(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di secondi sottratti. |
| MinusWeeks(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di settimane sottratte. |
| MinusYears(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di anni sottratti. |
| Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| NotifyAll() |
Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| Now() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Now(Clock) |
Ottiene l'ora corrente dall'orologio specificato. |
| Now(ZoneId) |
Ottiene l'ora corrente dall'orologio di sistema nel fuso orario specificato. |
| Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneId) |
Ottiene un'istanza di ZonedDateTime da un anno, un mese, un giorno, un'ora, un minuto, un secondo, un nanosecondo e un fuso orario. |
| Of(LocalDate, LocalTime, ZoneId) |
Ottiene un'istanza di ZonedDateTime da una data e un'ora locali. |
| Of(LocalDateTime, ZoneId) |
Ottiene un'istanza di ZonedDateTime da una data e ora locale. |
| OfInstant(Instant, ZoneId) |
Ottiene un'istanza di ZonedDateTime da un'istanza immediata. |
| OfInstant(LocalDateTime, ZoneOffset, ZoneId) |
Ottiene un'istanza di ZonedDateTime dall'istante formato combinando la data e l'offset locali. |
| OfLocal(LocalDateTime, ZoneId, ZoneOffset) |
Ottiene un'istanza di ZonedDateTime da una data e ora locale utilizzando l'offset preferito, se possibile. |
| OfStrict(LocalDateTime, ZoneOffset, ZoneId) |
Ottiene un'istanza di ZonedDateTime che convalida rigorosamente la combinazione di data e ora locale, offset e ID di zona. |
| Parse(ICharSequence, DateTimeFormatter) |
Ottiene un'istanza di ZonedDateTime da una stringa di testo usando un formattatore specifico. |
| Parse(ICharSequence) |
Ottiene un'istanza di ZonedDateTime da una stringa di testo, ad esempio 2007-12-03T10:15:30+01:00[Europa/Parigi]. |
| Parse(String, DateTimeFormatter) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Parse(String) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Plus(Int64, ITemporalUnit) |
Restituisce una copia di questa data e ora con l'importo specificato aggiunto. |
| Plus(ITemporalAmount) |
Restituisce una copia di questa data e ora con l'importo specificato aggiunto. |
| PlusDays(Int64) |
Restituisce una copia di zonedDateTime con il numero di giorni specificato aggiunto. |
| PlusHours(Int64) |
Restituisce una copia di zonedDateTime con il numero di ore specificato aggiunto. |
| PlusMinutes(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di minuti aggiunti. |
| PlusMonths(Int64) |
Restituisce una copia di zonedDateTime con il numero di mesi specificato aggiunto. |
| PlusNanos(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di nanosecondi aggiunti. |
| PlusSeconds(Int64) |
Restituisce una copia di zonedDateTime con il numero di secondi specificato aggiunto. |
| PlusWeeks(Int64) |
Restituisce una copia di zonedDateTime con il numero specificato di settimane aggiunte. |
| PlusYears(Int64) |
Restituisce una copia di zonedDateTime con il numero di anni specificato aggiunto. |
| Query(ITemporalQuery) |
Esegue query su questa data e ora usando la query specificata. |
| Range(ITemporalField) |
Ottiene l'intervallo di valori validi per il campo specificato. |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToLocalDate() |
Ottiene la parte LocalDate di questa data e ora. |
| ToLocalDateTime() |
Ottiene la parte LocalDateTime di questa data e ora. |
| ToLocalTime() |
Ottiene la parte LocalTime di questa data e ora. |
| ToOffsetDateTime() |
Converte questa data e ora in offsetDateTime. |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| TruncatedTo(ITemporalUnit) |
Restituisce una copia di zonedDateTime con l'ora troncata. |
| UnregisterFromRuntime() |
Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| Until(ITemporal, ITemporalUnit) |
Calcola la quantità di tempo fino a un'altra data e ora in termini di unità specificata. |
| Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
| Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| With(ITemporalAdjuster) |
Restituisce una copia modificata di questa data e ora. |
| With(ITemporalField, Int64) |
Restituisce una copia di questa data e ora con il campo specificato impostato su un nuovo valore. |
| WithDayOfMonth(Int32) |
Restituisce una copia di zonedDateTime con il giorno del mese modificato. |
| WithDayOfYear(Int32) |
Restituisce una copia di zonedDateTime con il giorno dell'anno modificato. |
| WithEarlierOffsetAtOverlap() |
Restituisce una copia di questa data/ora che modifica l'offset di fuso rispetto a quello precedente dei due offset validi in corrispondenza di una sovrapposizione della riga temporale locale. |
| WithFixedOffsetZone() |
Restituisce una copia di questa data e ora con l'ID di zona impostato sull'offset. |
| WithHour(Int32) |
Restituisce una copia di zonedDateTime con l'ora di giorno modificata. |
| WithLaterOffsetAtOverlap() |
Restituisce una copia di questa data/ora che modifica l'offset di fuso in un secondo momento dei due offset validi in corrispondenza di una sovrapposizione di ora locale. |
| WithMinute(Int32) |
Restituisce una copia di zonedDateTime con la modifica del minuto dell'ora. |
| WithMonth(Int32) |
Restituisce una copia di zonedDateTime con il mese dell'anno modificato. |
| WithNano(Int32) |
Restituisce una copia di zonedDateTime con il nano di secondo modificato. |
| WithSecond(Int32) |
Restituisce una copia di zonedDateTime con il secondo minuto modificato. |
| WithYear(Int32) |
Restituisce una copia di zonedDateTime con l'anno modificato. |
| WithZoneSameInstant(ZoneId) |
Restituisce una copia di questa data e ora con un fuso orario diverso, mantenendo l'istante. |
| WithZoneSameLocal(ZoneId) |
Restituisce una copia di questa data e ora con un fuso orario diverso, mantenendo la data e l'ora locale, se possibile. |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IChronoZonedDateTime.Plus(Int64, ITemporalUnit) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IChronoZonedDateTime.ToLocalDateTime() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IChronoZonedDateTime.With(ITemporalField, Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IChronoZonedDateTime.WithEarlierOffsetAtOverlap() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IChronoZonedDateTime.WithLaterOffsetAtOverlap() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IChronoZonedDateTime.WithZoneSameInstant(ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IChronoZonedDateTime.WithZoneSameLocal(ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IJavaPeerable.Disposed() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IJavaPeerable.Finalized() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IJavaPeerable.JniObjectReferenceControlBlock |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IJavaPeerable.UnregisterFromRuntime() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |