DateTimeParser

tipp

Der DateTimeParser ist nützlich wenn kurze Datumseingaben, z.B. 0101 ⇒ 01.01.2000 formatiert werden sollen.

documents.sdk.exitRegistry.registerFileFieldExitCallback("*", "InvoiceDate",
    function(documentsContext, options) {

        var maxYearBehind = 5;
        var maxYearFuture = 5;

        var fileContext = documentsContext.getFileContext();
        var date = fileContext.getFileFieldValue(options.fileFieldName);

        var formatted = DateTimeParser.tryParse(date, maxYearBehind, maxYearFuture);

        if (formatted == "") {
            var errorMessage = "Der erkannte Datumswert liegt vor oder nach der erlaubten Zeitspanne. \nZukunft: " +
                maxYearBehind + " Jahre\nVergangenheit: " + maxYearFuture + " Jahre";

            documentsContext.openMessageDialog("Datumskonvertierung", errorMessage);
            return
        }

        fileContext.setFileFieldValue(options.fileFieldName, formatted);
    });

DateTimeParser Members

tryParse string

Versucht den Übergabeparameter in ein Datum umzuwandeln und gibt diesen formatiert wieder zurück.

DateTimeParser.tryParse(input: string, maxYearBehind?: number, maxYearTo?: number): string

• static

Parameter:

• input: string: Ein String mit einem Datum
• maxYearBehind?: number: Gibt an wie lange das Jahr zurück liegen darf. Ist das Datum zu weit in der Vergangenheit, wird ein leerer String zurückgegeben.
• maxYearTo?: number: Gibt an wie lange das Jahr in der Zukunft liegen darf. Ist das Datum zu weit in der Zukunft, wird ein leerer String zurückgegeben.

Tag im aktuellen Monat:

const formattedDate = DateTimeParser.tryParse("01");
// 01.01.2000

const formattedDate = DateTimeParser.tryParse("1");
// 01.01.2000

Tag und Monat im aktuellen Jahr:

const formattedDate = DateTimeParser.tryParse("01.01");
// 01.01.2000

Tag, Monat und Jahr ohne Formatierung:

const formattedDate = DateTimeParser.tryParse("01012000");
// 01.01.2000

convertToFormattedDateString string

Konvertiert eine unformatierte Datumseingabe in ein formatierten Datums-String.

DateTimeParser.convertToFormattedDateString(input: string, format: string): string

• static

Parameter:

• input: string: Unformatierte Datumseingabe, z.B. 0101
• format: string: Das zu verwendene Format, z.B. DD.MM.YYYY

const formattedDate = DateTimeParser.convertToFormattedDateString("0101", "DD.MM.YYYY");
// 01.01

Parsen mit Formatangabe

const formattedDate = DateTimeParser.convertToFormattedDateString("01012000", "DD.MM.YYYY");
// 01.01.2000