Funcțiile Data, DateTime și Time

Se aplică pentru: planșă de lucru aplicații Fluxuri desktop Aplicații bazate pe model Power Pages Power Platform CLI

Convertește componentele dată și oră într-o valoare dată/oră.

Descriere

Funcția Date convertește valorile individuale An, Lună și Zi într-o valoare Dată/Oră. Porțiunea de timp este miezul nopții.

• Dacă Anul este cuprins între 0 și 1899 (inclusiv), funcția adaugă această valoare la 1900 pentru a calcula anul. 70 devine 1970.
• Dacă Luna este mai mică de 1 sau mai mare de 12, rezultatul scade sau adaugă mai multe luni de la începutul anului specificat.
• Dacă Ziua este mai mare decât numărul de zile din luna specificată, funcția adaugă mai multe zile în prima zi a lunii și returnează data corespunzătoare dintr-o lună ulterioară. Dacă Ziua este mai mică de 1, funcția scade mai multe zile, plus 1, din prima zi a lunii specificate.

Funcția Timp convertește valori individuale de oră, minut, secundă și, opțional, în milisecunde într-o valoare de dată/oră. Rezultatul nu are o dată asociată cu acesta.

Funcția DateTime combină Data și Ora funcții într-o singură funcție, luând atât argumente de dată, cât și de oră și returnând o valoare Date/Time care are atât componente de dată, cât și de oră.

Consultați funcțiile DateValue, TimeValue și DateTimeValue pentru informații despre modalitatea de convertire a unui șir într-o valoare.

Consultați și lucrul cu date și ore pentru mai multe informații.

Sintaxă

Dată( An, Lună, Zi )

• An - Obligatoriu. Numerele mai mari de 1899 sunt interpretate ca absolute (1980 sunt interpretate ca 1980); numerele cuprinse între 0 și 1899 sunt interpretate ca fiind relative la 1900. (De exemplu, 80 este interpretat ca 1980).
• Lună - Obligatoriu. Un număr care variază de la 1 la 12.
• Zi - Obligatoriu. Un număr care variază de la 1 la 31.

Timp( Ora, Minut, Al doilea [, Milisecunde ] )

• Oră - Obligatoriu. Număr de ore, de obicei în intervalul 0 (12:00 AM) la 23 (23:00 PM).
• Minut - Obligatoriu. Număr de minute, de obicei cuprins între 0 și 59.
• Secundă - Obligatoriu. Număr de secunde, de obicei cuprins între 0 și 59.
• Milisecunde - Opțional. Număr de milisecunde, de obicei cuprins între 0 și 999.

DataTime( Anul, Luna, Ziua, Ora, Minut, Al doilea [, Milisecunde ] )

• An - Obligatoriu. Numerele mai mari de 1899 sunt interpretate ca absolute (1980 sunt interpretate ca 1980); numerele cuprinse între 0 și 1899 sunt interpretate ca fiind relative la 1900. (De exemplu, 80 este interpretat ca 1980).
• Lună - Obligatoriu. Un număr care variază de la 1 la 12.
• Zi - Obligatoriu. Un număr care variază de la 1 la 31.
• Oră - Obligatoriu. Număr de ore, de obicei în intervalul 0 (12:00 AM) la 23 (23:00 PM)
• Minut - Obligatoriu. Număr de minute, de obicei cuprins între 0 și 59.
• Secundă - Obligatoriu. Număr de secunde, de obicei cuprins între 0 și 59.
• Milisecunde - Opțional. Număr de milisecunde, de obicei cuprins între 0 și 999.

Exemple

Data

Dacă un utilizator a tastat

• 1979 într-un control de introducere a textului numit HireYear
• 3 într-un control de introducere a textului numit HireMonth
• 17 într-un control de introducere a textului numit HireDay

Această formulă ar returna 3/17/1979:

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

Timp

Dacă un utilizator a tastat

• 14 într-un control de introducere a textului numit BirthHour
• 50 într-un control de introducere a textului numit BirthMinute
• 24 într-un control de introducere a textului numit BirthSecond

Această formulă ar returna 02:50:24 P:

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

DateTime

Dacă un utilizator a tastat

• 2023 într-un control de introducere a textului numit EclipseYear
• 10 într-un control de introducere a textului numit EclipseMonth
• 28 într-un control de introducere a textului numit EclipseDate
• 13 într-un control de introducere a textului numit EclipseHour
• 14 într-un control de introducere a textului numit EclipseMinute
• 5 într-un control de introducere a textului numit EclipseSecond
• 231 într-un control de introducere a textului numit EclipseMillisecond

Această formulă ar returna 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"
)