X++-runtimefuncties datum

In dit artikel worden de runtimefuncties voor datums beschreven.

dayName

Haalt de naam op van de dag van de week die overeenkomt met een getal.

str dayName(int number)

Parameters

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.

Voorbeeld

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)

Parameters

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.

Voorbeeld

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.

int dayOfWk(date date)

Parameters

Retourwaarde

Het aantal opgegeven dagen in de week.

Voorbeeld

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)

Parameters

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.

Voorbeeld

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)

Parameters

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)

Parameters

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

Voorbeeld

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)

Parameters

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.

Voorbeeld

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.

int mthOfYr(date date)

Parameters

Retourwaarde

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

Voorbeeld

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)

Parameters

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.

Voorbeeld

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)

Parameters

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die de functie in het volgende kwartaal vindt.

Opmerkingen

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

Voorbeeld

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)

Parameters

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.

Voorbeeld

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)

Parameters

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)

Parameters

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)

Parameters

Retourwaarde

De dichtstbijzijnde overeenkomst met de opgegeven datum die het systeem in het vorige jaar vindt.

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

Gebruik sessiedatum en -tijd in het menu Extra om de pagina Sessiedatum en -tijd te openen. Op deze pagina kunt u de sessiedatum instellen. Nadat het systeem deze setactie heeft gedetecteerd, retourneren volgende aanroepen naar de systemDateGet-functie de sessiedatum. De huidige functie retourneert de systeemdatum. Deze functie biedt geen ondersteuning voor tijdzones.

Voorbeeld

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)

Parameters

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

Voorbeeld

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.

Voorbeeld

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.

Voorbeeld

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)

Parameters

Retourwaarde

Het volgnummer van de week waarin de parameter _date voorkomt.

Voorbeeld

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

Parameters

Retourwaarde

Het jaar van de opgegeven datum.

Opmerkingen

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