Funzioni Date, DateTime e Time

Si applica a: App Canvas Flussi Desktop App basate su modello Power Pages 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

Data( Anno, Mese, Giorno )

• Anno - 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).
• Mese - Obbligatorio. Numero compreso nell'intervallo da 1 a 12.
• Giorno - Obbligatorio. Numero compreso nell'intervallo da 1 a 31.

Tempo( Ora, Minuto, Secondo [, Millisecondi ] )

• Ora - Obbligatorio. Numero di ore, in genere compreso tra 0 (00:00) e 23 (23:00).
• Minuto - Obbligatorio. Numero di minuti, in genere tra 0 e 59.
• Secondo - 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, Minuto, Secondo [, Millisecondi ] )

• Anno - 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).
• Mese - Obbligatorio. Numero compreso nell'intervallo da 1 a 12.
• Giorno - Obbligatorio. Numero compreso nell'intervallo da 1 a 31.
• Ora - Obbligatorio. Numero di ore, in genere compreso tra 0 (00:00) e 23 (23:00)
• Minuto - Obbligatorio. Numero di minuti, in genere tra 0 e 59.
• Secondo - 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 immissione testo denominato HireYear
• 3 in un controllo di immissione testo denominato HireMonth
• 17 in un controllo di immissione 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 immissione testo denominato BirthHour
• 50 in un controllo di immissione testo denominato BirthMinute
• 24 in un controllo di immissione 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 immissione testo denominato EclipseYear
• 10 in un controllo di immissione testo denominato EclipseMonth
• 28 in un controllo di immissione testo denominato EclipseDate
• 13 in un controllo di immissione testo denominato EclipseHour
• 14 in un controllo di immissione testo denominato EclipseMinute
• 5 in un controllo di immissione testo denominato EclipseSecond
• 231 in un controllo di immissione 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"
)