Date-, DateTime- en Time-functies

Van toepassing op: Canvas-apps Bureaubladstromen Modelgestuurde apps Power Platform CLI

Hiermee worden datum- en tijdonderdelen omgezet naar een datum/tijd-waarde.

Omschrijving

De functie Date zet afzonderlijke waarden voor Year, Month en Day om naar een datum/tijd-waarde. Het tijdgedeelte is middernacht.

• Als het jaar tussen 0 en 1899 ligt, voegt de functie die waarde toe aan 1900 om het jaar te berekenen. 70 wordt 1970.
• Als Month kleiner dan 1 of groter dan 12 is, wordt de hoeveelheid maanden in het resultaat afgetrokken van of toegevoegd aan het begin van het opgegeven jaar.
• Als Day groter is dan het aantal dagen in de opgegeven maand, voegt de functie de hoeveelheid dagen toe aan de eerste dag van de maand en retourneert deze de overeenkomstige datum van de volgende maand. Als Day kleiner dan 1 is, trekt de functie het aantal dagen, plus 1, af van de eerste dag van de opgegeven maand.

De functie Time zet afzonderlijke waarden voor Hour, Minute, Second en eventueel Millisecond om naar een Date/Time-waarde. Het resultaat is niet aan een datum gekoppeld.

De functie DateTime combineert de functies Date en Time in één enkele functie, waarbij zowel datum- als tijdargumenten worden gebruikt en een datum/tijd-waarde wordt geretourneerd die zowel datum- als tijdonderdelen bevat.

Zie de functies DateValue, TimeValue en DateTimeValue voor informatie over het omzetten van een tekenreeks naar een waarde.

Zie ook Werken met datums en tijden voor meer informatie.

Syntaxis

Date( Year, Month, Day )

• Year: vereist. Cijfers die groter zijn dan 1899 worden geïnterpreteerd als absolute waarden (1980 wordt geïnterpreteerd als 1980). Getallen van 0 t/m 1899 worden geïnterpreteerd in verhouding tot 1900. (80 wordt bijvoorbeeld geïnterpreteerd als 1980.)
• Month: vereist. Een getal van 1 t/m 12.
• Day: vereist. Een getal van 1 t/m 31.

Time( Hour, Minute, Second [, Milliseconds ] )

• Hour: vereist. Aantal uren, meestal tussen 0 (00:00 uur) en 23 (23:00 uur).
• Minute: vereist. Aantal minuten, meestal tussen 0 en 59.
• Second: vereist. Aantal seconden, meestal tussen 0 en 59.
• Milliseconds - Optioneel. Aantal milliseconden, meestal tussen 0 en 999.

DateTime( Year, Month, Day, Hour, Minute, Second [, Milliseconds ] )

• Year: vereist. Cijfers die groter zijn dan 1899 worden geïnterpreteerd als absolute waarden (1980 wordt geïnterpreteerd als 1980). Getallen van 0 t/m 1899 worden geïnterpreteerd in verhouding tot 1900. (80 wordt bijvoorbeeld geïnterpreteerd als 1980.)
• Month: vereist. Een getal van 1 t/m 12.
• Day: vereist. Een getal van 1 t/m 31.
• Hour: vereist. Aantal uren, meestal tussen 0 (00:00 uur) en 23 (23:00 uur)
• Minute: vereist. Aantal minuten, meestal tussen 0 en 59.
• Second: vereist. Aantal seconden, meestal tussen 0 en 59.
• Milliseconds - Optioneel. Aantal milliseconden, meestal tussen 0 en 999.

Voorbeelden

Date

Heeft een gebruiker het volgende getypt

• 1979 in een besturingselement voor tekstinvoer met de naam HireYear
• 3 in een besturingselement voor tekstinvoer met de naam HireMonth
• 17 in een besturingselement voor tekstinvoer met de naam HireDay

Deze formule zou 3/17/1979 retourneren:

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

Tijd

Heeft een gebruiker het volgende getypt

• 14 in een besturingselement voor tekstinvoer met de naam BirthHour
• 50 in een besturingselement voor tekstinvoer met de naam BirthMinute
• 24 in een besturingselement voor tekstinvoer met de naam BirthSecond

Deze formule zou 02:50:24 P retourneren:

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

Datum en tijd

Heeft een gebruiker het volgende getypt

• 2023 in een besturingselement voor tekstinvoer met de naam EclipseYear
• 10 in een besturingselement voor tekstinvoer met de naam EclipseMonth
• 28 in een besturingselement voor tekstinvoer met de naam EclipseDate
• 13 in een besturingselement voor tekstinvoer met de naam EclipseHour
• 14 in een besturingselement voor tekstinvoer met de naam EclipseMinute
• 5 in een besturingselement voor tekstinvoer met de naam EclipseSecond
• 231 in een besturingselement voor tekstinvoer met de naam EclipseMillisecond

Deze formule zou 10/28/23 01:14:05.231 PM retourneren:

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"
)