Funzioni Date, DateTime e Time

  • Articolo

Si applica a: app canvas flussi desktop app basate su modello Power Platform CLI

Convertono i componenti di data e ora in un valore di data/ora.

Descrizione

La funzione Date converte singoli valori di anno, mese e giorno in un valore di data/ora. La parte dell'ora corrisponde alla mezzanotte.

  • Se il valore dell'anno è compreso tra 0 e 1899 (inclusi), la funzione aggiunge tale valore a 1900 per calcolare l'anno. 70 diventa 1970.
  • Se il valore del mese è inferiore a 1 o superiore a 12, il risultato viene ottenuto sottraendo o aggiungendo tale numero di mesi dall'inizio dell'anno specificato.
  • Se il valore del giorno è superiore al numero di giorni nel mese specificato, la funzione aggiunge tale numero di giorni al primo giorno del mese e restituisce la data corrispondente di un mese successivo. Se il valore del giorno è inferiore a 1, la funzione sottrae tale numero di giorni più 1 dal primo giorno del mese specificato.

La funzione Time converte singoli valori di ore, minuti, secondi e facoltativamente millisecondi in un valore di data/ora. Al risultato non è associata alcuna data.

La funzione DateTime combina le funzioni Date e Time in un'unica funzione, prendendo entrambi gli argomenti data e ora e restituendo un valore data/ora con componenti sia di data che di ora.

Per informazioni sulla conversione di una stringa in un valore, vedere le funzioni DateValue, TimeValue e DateTimeValue.

Per altre informazioni, vedere Utilizzo di date e ore.

Sintassi

Date( Year, Month, Day )

  • Year: obbligatorio. I numeri superiori a 1899 vengono interpretati come assoluti (1980 viene interpretato come 1980). I numeri compresi nell'intervallo da 0 a 1899 vengono interpretati come relativi a 1900 (ad esempio, 80 viene interpretato come 1980).
  • Month: obbligatorio. Numero compreso nell'intervallo da 1 a 12.
  • Day: obbligatorio. Numero compreso nell'intervallo da 1 a 31.

Time( Ore, Minuti, Secondi [, Millisecondi ] )

  • Hour: obbligatorio. Numero di ore, in genere compreso tra 0 (00:00) e 23 (23:00).
  • Minute: obbligatorio. Numero di minuti, in genere tra 0 e 59.
  • Second: obbligatorio. Numero di secondi, in genere tra 0 e 59.
  • Millisecondi: facoltativo. Numero di millisecondi, in genere tra 0 e 999.

DateTime( Anno, Mese, Giorno, Ora, Minuti, Secondi [, Millisecondi ] )

  • Year: obbligatorio. I numeri superiori a 1899 vengono interpretati come assoluti (1980 viene interpretato come 1980). I numeri compresi nell'intervallo da 0 a 1899 vengono interpretati come relativi a 1900 (ad esempio, 80 viene interpretato come 1980).
  • Month: obbligatorio. Numero compreso nell'intervallo da 1 a 12.
  • Day: obbligatorio. Numero compreso nell'intervallo da 1 a 31.
  • Hour: obbligatorio. Numero di ore, in genere compreso tra 0 (00:00) e 23 (23:00)
  • Minute: obbligatorio. Numero di minuti, in genere tra 0 e 59.
  • Second: obbligatorio. Numero di secondi, in genere tra 0 e 59.
  • Millisecondi: facoltativo. Numero di millisecondi, in genere tra 0 e 999.

Esempi

Date

Se un utente digitasse

  • 1979 in un controllo di input di testo denominato HireYear
  • 3 in un controllo di input di testo denominato HireMonth
  • 17 in un controllo di input di testo denominato HireDay

questa formula renderebbe 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Ora

Se un utente digitasse

  • 14 in un controllo di input di testo denominato BirthHour
  • 50 in un controllo di input di testo denominato BirthMinute
  • 24 in un controllo di input di testo denominato BirthSecond

questa formula renderebbe 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

Data/Ora

Se un utente digitasse

  • 2023 in un controllo di input di testo denominato EclipseYear
  • 10 in un controllo di input di testo denominato EclipseMonth
  • 28 in un controllo di input di testo denominato EclipseDate
  • 13 in un controllo di input di testo denominato EclipseHour
  • 14 in un controllo di input di testo denominato EclipseMinute
  • 5 in un controllo di input di testo denominato EclipseSecond
  • 231 in un controllo di input di testo denominato EclipseMillisecond

questa formula renderebbe 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)