X++-runtimefuncties datum

In dit artikel worden de runtimefuncties voor datums beschreven.

dayName

Haalt de naam op van de dag van de week die is opgegeven door een getal.

str dayName(int number)

Parameterwaarden

Retourwaarde

De dag van de week die is opgegeven door de getalparameter.

Opmerkingen

De geldige waarden voor de getalparameter zijn 1 tot en met 7. Maandag wordt vertegenwoordigd door 1, dinsdag bij 2 en zondag door 7.

Example

static void dayNameExample(Args _arg)
{
    str s = dayName(1);
    print "First day of the week's name is " + s;
    pause;
}

dayOfMth

Berekent het aantal dagen in de maand voor de opgegeven datum.

int dayOfMth(date date)

Parameterwaarden

Retourwaarde

Een geheel getal tussen 1 en 31 dat de dag van de maand aangeeft voor de opgegeven datum.

Opmerkingen

dayOfMth(31\12\2001) // returns 31.

Example

static void dayOfMthExample(Args _arg)
{
    date d = today();
    int i = dayOfMth(d);

    print "Today's day of the month is " + int2Str(i);
    pause;
}

dayOfWk

Berekent het aantal dagen in de week voor de opgegeven datum. Notitie: Maandag wordt vertegenwoordigd door 1, dinsdag bij 2 en zondag door 7.

int dayOfWk(date date)

Parameterwaarden

Retourwaarde

Het aantal opgegeven dagen in de week.

Example

static void dayOfWkExample(Args _arg)
{
    date d = today();
    int i = dayOfWk(d);

    print "Today's day of the week is " + int2Str(i);
    pause;
}

dayOfYr

Berekent het aantal dagen tussen 1 januari en de opgegeven datum.

int dayOfYr(date _date)

Parameterwaarden

Retourwaarde

Het aantal dagen tussen 1 januari en de opgegeven datum, inclusief.

Opmerkingen

1 januari is 1 en 31 december is 365 of 366 , afhankelijk van of het jaar een schrikkeljaar is.

Example

static void dayOfYrExample(Args _arg)
{
    date d = today();
    int i = dayOfYr(d);

    print "Today's day of the year is " + int2Str(i);
    pause;
}

endMth

Berekent de laatste datum in de maand van de opgegeven datum.

date endMth(date date)

Parameterwaarden

Retourwaarde

De datumwaarde van de laatste dag in de opgegeven maand.

Opmerkingen

endMth(02\2\1988); //Returns the date 29\2\1988 because 1988 is a leap year.
endMth(02\2\1989); //Returns the date 28\2\1989.

mkDate

Hiermee maakt u een datum op basis van drie gehele getallen die respectievelijk de dag, maand en het jaar aangeven.

date mkDate(int day, int month, int year)

Parameterwaarden

Retourwaarde

Een datumwaarde die is gebaseerd op de waarden van de parameters dag, maand en jaar .

Opmerkingen

Als de datum niet geldig is, retourneert deze methode een datum van 0 (nul, 1-1-1-1900).

Example

static void mkDateExample(Args _arg)
{
    date d;
    
    // Returns the date 01\01\2005.
    d = mkDate(1, 1, 2005);
    print d;
    pause;
}

mthName

Haalt de naam van de opgegeven maand op

str monthName(int number)

Parameterwaarden

Retourwaarde

De naam van de opgegeven maand.

Opmerkingen

De geldige waarden van de getalparameter zijn 1 tot en met 12. Januari wordt vertegenwoordigd door 1 en december door 12.

Example

static void mthNameExample(Args _arg)
{
    // MthName(6) returns the text string "June".
    str s = mthName(6);

    print "Month name is " + s;
    pause;
}

mthOfYr

Hiermee wordt het nummer van de maand in het jaar voor de opgegeven datum opgehaald. Notitie: Januari is 1, februari is 2 en december is 12.

int mthOfYr(date date)

Parameterwaarden

Retourwaarde

Het getal van de maand in het jaar, voor de maand die wordt vertegenwoordigd door de datumparameter .

Example

static void mthOfYrExample(Args _arg)
{
    int i = mthOfYr(today());

    print "The number of the month in today's date is " + int2Str(i);
    pause;
}

nextMth

Haalt de datum op in de volgende maand die het meest overeenkomt met de opgegeven datum.

date nextMth(date date)

Parameterwaarden

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die in de volgende maand wordt gevonden.

Opmerkingen

nextMth(29\2\1996); //returns 29/03/1996.
nextMth(31\1\1996); //returns 2921996, because 1996 is a leap year.

Example

static void nextMthExample(Args _arg)
{
    date d = nextMth(today());

    print "Closest date next month is "
    + date2Str(d, 2, 2, -1, 2, -1, 4);
    pause;
}

nextQtr

Haalt de datum op in het volgende kwartaal dat het meest overeenkomt met de opgegeven datum.

date nextQtr(date date)

Parameterwaarden

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die in het volgende kwartaal wordt gevonden.

Opmerkingen

NextQtr(31\1\1998) retourneert bijvoorbeeld 30\4\1998.

Example

static void nextQtrExample(Args _arg)
{
    date d = nextQtr(today());

    print "Closest date next quarter is "
        + date2Str(d, 2, 2, -1, 2, -1, 4);
    pause;
}

nextYr

Haalt de datum in het volgende jaar op die het meest overeenkomt met de opgegeven datum.

date nextYr(date date)

Parameterwaarden

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die in het volgende jaar wordt gevonden.

Opmerkingen

Nextyr(29\2\1998) retourneert bijvoorbeeld 28\2\1999.

Example

static void nextYrExample(Args _arg)
{
    date d = nextYr(today());

    print "Closest date next year is "
        + date2Str(d, 2, 2, -1, 2, -1, 4);
    pause;
}

prevMth

Hiermee wordt de datum in de vorige maand opgehaald die het dichtst bij de opgegeven datum hoort.

date prevMth(date date)

Parameterwaarden

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die in de vorige maand is gevonden.

Opmerkingen

prevMth(31\3\1996); // Returns the date 29/02/1996 because 1996 is a leap year.
prevMth(28\2\1998); // Returns the date 28/01/1998.

prevQtr

Haalt de datum in het vorige kwartaal op die het meest overeenkomt met de opgegeven datum.

date prevQtr(date date)

Parameterwaarden

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die in het vorige kwartaal wordt gevonden.

Opmerkingen

prevQtr(30\4\1998); // Returns the date 30/01/1998.
prevQtr(29\5\1996); // Returns the date 29/02/1996, because 1996 is a leap year.

prevYr

Hiermee wordt de datum in het vorige jaar opgehaald die het meest overeenkomt met de opgegeven datum.

date prevYr(date date)

Parameterwaarden

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die in het vorige jaar wordt gevonden.

Opmerkingen

prevYr(29\2\1996); //Returns the date 28/02/1995 because 1996 is a leap year.
prevYr(28\2\1998); //Returns the date 28/02/1997.

systemDateGet

Haalt de sessiedatum op als deze is ingesteld.

date systemDateGet()

Retourwaarde

De sessiedatum als deze is ingesteld; anders, de systeemdatum.

Opmerkingen

Overweeg sessiedatum en -tijd te gebruiken in het menu Extra om de pagina Sessiedatum en -tijd te openen. Deze pagina kan worden gebruikt om de sessiedatum actief in te stellen. Nadat deze setactie door het systeem is gedetecteerd, retourneren volgende aanroepen naar de systemDateGet-functie de sessiedatum. De huidige functie retourneert de systeemdatum. Deze functie biedt geen ondersteuning voor tijdzones.

Example

In het volgende voorbeeld ziet u de datum in het venster Infolog.

static void Job_systemDateGet(Args _arg)
{
    info( date2Str(
        systemDateGet(),        // X++ language function.
        321,                    // 321 = ymd
        DateDay::Digits2,
        DateSeparator::Hyphen,  // separator1
        DateMonth::Digits2,
        DateSeparator::Hyphen,  // separator2
        DateYear::Digits4
    )
);
/*********** Actual Infolog output
Message (03:46:00 pm)
2012-04-16
***********/
}

systemDateSet

Hiermee wijzigt u de systeemdatum.

date systemDateSet(date _date)

Parameterwaarden

Retourwaarde

De nieuwe systeemdatum.

Opmerkingen

Deze functie heeft geen invloed op de sessiedatum. Met deze methode wordt de datum gewijzigd, maar de tijd wordt ingesteld op 0 (nul).

Example

In het volgende voorbeeld wordt de systeemdatum ingesteld op de datum van vandaag.

static void systemDateSetExample(Args _arg)
{
    date d = today();
    d = systemDateSet(d);
    print d;
}

timeNow

Haalt de huidige systeemtijd op.

int timeNow()

Retourwaarde

Het aantal seconden dat sinds middernacht is verstreken.

Example

static void timeNowExample(Args _arg)
{
    int i = timeNow();

    print "The number of seconds since midnight is " + int2Str(i);
    pause;
}

Vandaag

Haalt de huidige datum op het systeem op.

date today()

Retourwaarde

De huidige datum.

Example

static void todayExample(Args _arg)
{
    date d = today();
    
    print "Today's date is " + date2Str(d, 0, 2, -1, 2, -1, 4);
    pause;
}

wkOfYr

Berekent de week van het jaar waarin een datum valt volgens de ISO 8601-specificatie.

int wkOfYr(date _date)

Parameterwaarden

Retourwaarde

Het volgnummer van de week waarin de parameter _date voorkomt.

Example

In het volgende codevoorbeeld wordt de functie wkOfYr vergeleken met de methode Global::weekOfYear . De functie en de methode produceren verschillende resultaten.

// X++ job, under AOT > Jobs.
static void WeekTests3Job(Args _args)
{
    int weekNum, i;
    date dateTest;
    str sMessages[];

    //---------------------------------------------
    sMessages[1] = "----- #1.  For Sunday, January 5, 2003 -----";
    dateTest = 512003; // DayMonthYear  format.
    weekNum = wkOfYr(dateTest);
    sMessages[2] = int2str(weekNum) + " = wkOfYr funtion";
    weekNum = Global::weekOfYear(dateTest);
    sMessages[3] = int2str(weekNum) + " = Global::weekOfYear method";
    
    //---------------------------------------------
    sMessages[4] = " ";
    sMessages[5] = "----- #2.  For Wednesday, August 20, 2003 -----";
    dateTest = 2082003;
    weekNum = wkOfYr(dateTest);
    sMessages[6] = int2str(weekNum) + " = wkOfYr funtion";
    weekNum = Global::weekOfYear(dateTest);
    sMessages[7] = int2str(weekNum) + " = Global::weekOfYear method";
    
    //---------------------------------------------
    sMessages[8] = " ";
    sMessages[9] = "----- #3.  For Sunday, December 28, 2003 -----";
    dateTest = 28122003;
    weekNum = wkOfYr(dateTest);
    sMessages[10] = int2str(weekNum) + " = wkOfYr funtion";
    weekNum = Global::weekOfYear(dateTest);
    sMessages[11] = int2str(weekNum) + " = Global::weekOfYear method";
    
    for (i=1; i<= 11; i++)
    {
        Global::info(sMessages[i]);
    }
}

In het vorige voorbeeld is de volgende informatie verzonden naar het Infolog voor weergave. In de uitvoer ziet u dat er verschillen zijn tussen wkOfYr en Global::weekOfYear.

Message (01:59:13 pm) ----- 
#1. For Sunday, January 5, 2003 ----- 1 = wkOfYr function 2 = Global::weekOfYear method ----- 
#2. For Wednesday, August 20, 2003 ----- 34 = wkOfYr function 34 = Global::weekOfYear method ----- 
#3. For Sunday, December 28, 2003 ----- 52 = wkOfYr function 1 = Global::weekOfYear method

jaar

Haalt het jaar op uit een datumwaarde .

int year(date _date)

Parameterwaarden

Retourwaarde

Het jaar van de opgegeven datum.

Opmerkingen

year(0221998); //Returns the value 1998.