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.Interop.IJavaPeerable, 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 |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| 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) |
| JniPeerMembers |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Minute |
Ottiene il campo minuto dell'ora. |
| Month |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MonthValue |
Ottiene il campo mensile dell'anno compreso tra 1 e 12. |
| Nano |
Ottiene il campo nano-di secondo. |
| Offset |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| 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 |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
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 |
| 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) |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| Format(DateTimeFormatter) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| From(ITemporalAccessor) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Get(ITemporalField) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| GetHashCode() |
Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object) |
| GetLong(ITemporalField) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IsSupported(ITemporalField) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| IsSupported(ITemporalUnit) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| 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) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Minus(ITemporalAmount) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusDays(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusHours(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusMinutes(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusMonths(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusNanos(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusSeconds(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusWeeks(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| MinusYears(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| 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) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Now(ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Of(LocalDate, LocalTime, ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Of(LocalDateTime, ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| OfInstant(Instant, ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| OfInstant(LocalDateTime, ZoneOffset, ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| OfLocal(LocalDateTime, ZoneId, ZoneOffset) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| OfStrict(LocalDateTime, ZoneOffset, ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Parse(ICharSequence, DateTimeFormatter) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Parse(ICharSequence) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| 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) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Plus(ITemporalAmount) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusDays(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusHours(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusMinutes(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusMonths(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusNanos(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusSeconds(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusWeeks(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| PlusYears(Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Query(ITemporalQuery) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| Range(ITemporalField) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToLocalDate() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| ToLocalDateTime() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| ToLocalTime() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| ToOffsetDateTime() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| TruncatedTo(ITemporalUnit) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| UnregisterFromRuntime() |
Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| Until(ITemporal, ITemporalUnit) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| 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) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| With(ITemporalField, Int64) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithDayOfMonth(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithDayOfYear(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithEarlierOffsetAtOverlap() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithFixedOffsetZone() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithHour(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithLaterOffsetAtOverlap() |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithMinute(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithMonth(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithNano(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithSecond(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithYear(Int32) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithZoneSameInstant(ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
| WithZoneSameLocal(ZoneId) |
Data e ora con un fuso orario nel sistema di calendario ISO-8601, ad esempio |
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() |
Notifica al runtime di interoperabilità che il peer gestito è stato eliminato. (Ereditato da Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
Rilascia questo Java peer a meno che non venga conservato da un altro riferimento gestito. (Ereditato da Object) |
| IJavaPeerable.Finalized() |
Notifica al runtime di interoperabilità che il peer gestito è stato finalizzato. (Ereditato da Object) |
| IJavaPeerable.JniManagedPeerState |
Ottiene lo stato che descrive la relazione tra questo peer gestito e il relativo riferimento JNI. (Ereditato da Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Imposta il codice hash dell'identità di interoperabilità per questo Java peer. (Ereditato da Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Imposta lo stato peer gestito e JNI per questo peer Java. (Ereditato da Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Imposta il riferimento all'oggetto JNI usato da questo peer gestito. (Ereditato da Object) |
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 |