Liste benutzerdefinierter Funktionen

Funktion

Parameter

Rückgabetyp

Beschreibung

Display_Name(Vor;Nach[;Init[;Titel[;Suffix]]])

Zeichen

Zeichen

Durch diese Funktion wird der volle Name der einzelnen Namensteile zurückgegeben: <1>Vorname</1>, <2>Nachname</2>, <3>zweiter Vorname</3>, <4>Anrede (z. B., „Frau“)</4>, <5>Suffix (z. B. „M.A.“)</5>

Value_XL(Text)

Zeichen

Numerisch

Diese Funktion konvertiert eine <1>Textzeichenfolge<1>, die eine Zahl oder Nummer darstellt, in die betreffende Zahl oder Nummer, Dies ist ein Excel-Funktionsname für die interne Funktion VAL.

Char_XL(Nummer)

Numerisch

Zeichen

Durch diese Funktion wird das Zeichen zurückgegeben, das durch den <1>Zeichensatzcode<1> Ihres Computers angegeben wurde. Dies ist ein Excel-Funktionsname für die interne Funktion CHR.

Code_XL(Text)

Zeichen

Numerisch

Diese Funktion gibt einen numerischen Code für das erste Zeichen in einer <1>Textzeichenfolge<1> zurück, und zwar in dem durch Ihren Computer verwendeten Zeichensatz. Dies ist ein Excel-Funktionsname für die interne Funktion ASC.

Search_XL(Suchtext;Durchsuchtext;Startnummer)

Zeichen, Zeichen, Numerisch

Numerisch

Durch diese Funktion wird die Zeichennummer angegeben, bei der ein bestimmtes <1>Zeichen oder eine bestimmte Textzeichenfolge<1> zuerst festgestellt wurde, während von links nach rechts gelesen wurde. Diese Funktion ist nicht groß-/klein-sensitiv. Es handelt sich hier um eine Excel-Funktion, die die internen Funktionen INSTR und SUBSTR verwendet.

Mid_XL(Text;Startnummer;Zeichenanzahl)

Zeichen, Numerisch, Numerisch

Zeichen

Diese Funktion gibt die Zeichen aus der Mitte einer <1>Textzeichenfolge<1> zurück, sofern <2>Startposition<2> und <3>Länge<3> angegeben werden. Dies ist der Excel-Funktionsname für die interne Funktion SUBSTR.

Replace_XL(alter_Text;Startnummer;Zeichenanzahl;neuer_Text)

Zeichen, Numerisch, Numerisch, Zeichen

Zeichen

Diese Funktion ersetzt einen Teil der <1>vorhandenen Textzeichenfolge<1> durch eine <4>neue Textzeichenfolge<4>, und zwar unter Verwendung einer <3>bestimmten Anzahl von Zeichen<3>, die an einer <2>bestimmten Position<2> beginnen. Dieses ist ein Excel-Funktionsname für die intrinsische Funktion Stuff.  Es gibt bereits eine interne Funktion, die REPLACE genannt wird Siehe auch Substitute.

Substitute_XL(Text;alter_Text;neuer_Text)

Zeichen, Zeichen, Zeichen

Zeichen

Durch diese Funktion wird in einer <1>Textzeichenfolge<1> der <2>vorhandene Text<2> durch <3>neuen Text<3> ersetzt. Dieses ist der Excel-Funktionsname für die interne Funktion REPLACE.

Trunc_XL(Zahl)

Numerisch

Numerisch

Diese Funktion stutzt eine <1>Zahl<1>, indem die Dezimalstellen entfernt werden. Dieses ist ein Excel-Funktionsname für die interne Funktion INT.

Parse_Path(dateispez;Abschnitt)

Zeichen, Zeichen

Zeichen

Ruft den festgelegten <1>Abschnitt<1> eines <2>Pfades<2> auf. Gültige Abschnitte sind Laufwerk, Ordner, Dateiname, Nur_Dateiname (Dateiname ohne Erweiterung), Pfad (kompletter Pfad ohne Dateiname) und Nur-Erweiterung.

Even_XL(number)

Numerisch

Numerisch

Durch diese Funktion wird eine positive Zahl auf die nächstgelegene gerade Ganzzahl aufgerundet und eine negative Zahl entsprechend abgerundet. Es handelt sich hier um eine Excel-Funktion für die internen Funktionen MOD und CEILING.

Odd_XL(Zahl)

Numerisch

Numerisch

Durch diese Funktion wird eine positive Zahl auf die nächstgelegene ungerade Ganzzahl aufgerundet und eine negative Zahl entsprechend abgerundet. Es handelt sich hier um eine Excel-Funktion für die internen Funktionen MOD und CEILING.

Sign_XL(Zahl)

Numerisch

Numerisch

Diese Funktion zeigt an, ob eine Zahl positiv oder negativ ist: 1, wenn die Zahl positiv ist, 0, wenn die Zahl null ist, -1, wenn die Zahl negativ ist. Dies ist eine Excel-Funktion, die die interne Funktion IF verwendet.

Concatenate_XL()

Zeichen (beschränkt auf 12 Zeichenfolgen)

Zeichen

Durch diese Funktion werden mehrere Textzeichenfolgen miteinander verkettet. Beschränkt auf 12 Zeichenfolgen. Diese Funktion entspricht der ähnlichen Funktion in Excel.  Zeichenfolgen können auch mithilfe des Operators + verknüpft werden.

MonthName_Eng(Datum)

Datum/Uhrzeit

Zeichen

Diese Funktion gibt den englischen Monatsnamen für ein bestimmtes <1>Datum<1> zurück. Beispielsweise gibt 01.01.2007 „Januar“ zurück.

WeekdayName_Eng(Datum)

Datum/Uhrzeit

Zeichen

Diese Funktion gibt den englischen Wochentagnamen für ein bestimmtes <1>Datum<1> zurück.

Check_SSN(SSN)

Zeichen

Numerisch

Durch diese Funktion kann auf einfache Weise eine in einer Zeichenfolge enthaltene US-Sozialversicherungsnummer (SSN) überprüft werden.  Die Funktion gibt 1 zurück, wenn es sich um eine gültige Nummer handelt; andernfalls wird 0 zurückgegeben.  Beachten Sie bitte, dass diese Funktion nur zum Vermeiden von einfachen Dateneintragsfehlern verwendet werden sollte und nicht zum Verhindern von betrügerischen Nummern.

Check_NINumber(NIN-Nummer)

Zeichen

Numerisch

Dies ist eine einfache Überprüfungsmethode für soziale Krankenversicherungsnummern (NIN) aus Großbritannien. Die Funktion gibt 1 zurück, wenn es sich um eine gültige Nummer handelt; andernfalls wird 0 zurückgegeben.  Beachten Sie bitte, dass diese Funktion nur zum Vermeiden von einfachen Dateneintragsfehlern verwendet werden sollte und nicht zum Verhindern von betrügerischen Nummern.

Check_NHSNumber(NHS-Nummer)

Numerisch

Numerisch

Überprüft eine UK-Krankenversicherungsnummer (NHS) anhand der Regeln unter http://www.govtalk.gov.uk/gdsc/html/noframes/NHSnumber-2-0-Release.htm.  Die Funktion gibt 1 zurück, wenn es sich um eine gültige Nummer handelt; andernfalls wird 0 zurückgegeben. Beachten Sie bitte, dass diese Funktion nur zum Vermeiden von einfachen Dateneintragsfehlern verwendet werden sollte und nicht zum Verhindern von Betrugsversuchen.

Check_CC(Kreditkartennummer)

Zeichen

Numerisch

Überprüft <1>eine Zeichenfolge, die eine Kreditkartennummer darstellt<1>, auf Übereinstimmung mit der LUHN- oder MOD 10-Formel.  Beachten Sie bitte, dass diese Funktion nur für Karten mit 13, 14, 15 oder 16 Ziffern verwendet werden kann.  Die Funktion gibt 1 zurück, wenn es sich um eine gültige Nummer handelt; andernfalls wird 0 zurückgegeben. Beachten Sie bitte, dass diese Funktion nur zum Vermeiden von einfachen Dateneintragsfehlern verwendet werden sollte und nicht zum Verhindern von Betrugsversuchen.

JulianCalendarDate_To_Date(Julian-Datum)

Numerisch

Datum/Uhrzeit

Durch diese Funktion wird ein <1>julianisches Kalenderdatum<1> (z. B. 2450000) in ein Datum konvertiert. Diese Funktion befasst sich nicht mit Bruchteilen des julianischen Kalenders, d. h. mit Zeitwerten.

Pi()

 

Numerisch

Durch diese Funktion wird der Wert Pi auf 8 Dezimalstellen genau zurückgegeben.

Euro_To_Legacy_Currency(Euro_Betrag;Währung)

Numerisch, Zeichen

Numerisch

Diese Funktion konvertiert einen <1>Eurobetrag<1> in eine ältere Währung, für die neuerdings der Euro verwendet wird.  Folgende <2>Währungskennzeichen<2> werden als gültig erkannt: ATS, BEF, DEM, ESP, FIM, FRF, GRD, IEP, ITL, LUF, NLG, PTE und VAL.  Bei Eingabe einer unbekannten Währung gibt die Funktion den Wert 0 zurück.

Legacy_Currency_To_Euro(Altwährungsbetrag;Währung)

Numerisch, Zeichen

Numerisch

Legacy_Currency_To_Euro(Altwährungsbetrag;Währung) – Diese Funktion konvertiert eine <1>Altwährung<1>, für die jetzt der Euro verwendet wird, in einen Eurobetrag. Folgende <2>Währungskennzeichen<2> werden als gültig erkannt: ATS, BEF, DEM, ESP, FIM, FRF, GRD, IEP, ITL, LUF, NLG, PTE und VAL.  Bei Eingabe einer unbekannten Währung gibt die Funktion den Wert 0 zurück.

Format_SSN(SSN;Formattyp)

Zeichen, Zeichen

Zeichen

Durch diese Funktion wird eine US-<1>Sozialversicherungsnummer (SSN)<1> formatiert.  Um die Bindestriche aus einer SSN zu entfernen oder zu einer SSN hinzuzufügen, muss jeweils der entsprechende <2>Formattyp<2> angegeben werden.

End_Of_Previous_Month([Eingabedatum])

Datum/Uhrzeit

Datum/Uhrzeit

Diese Funktion gibt bei einem optional angegebenen <1>Datum<1> das Datum des letzten Tages des vorherigen Monats zurück. Wenn kein Datum angegeben ist, wird angenommen, dass es sich bei dem Eingabedatum um das heutige Datum handelt.

Start_Of_Current_Month([Eingabedatum])

Datum/Uhrzeit

Datum/Uhrzeit

Diese Funktion gibt bei einem optional angegebenen <1>Datum<1> das Datum des ersten Tages des Monats zurück. Wenn kein Datum angegeben ist, wird angenommen, dass es sich bei dem Eingabedatum um das heutige Datum handelt.

Tomorrow()

 

Datum/Uhrzeit

Diese Funktion gibt das morgige Datum zurück.

Yesterday()

 

Datum/Uhrzeit

Diese Funktion gibt das gestrige Datum zurück.

Start_Of_Working_Week(Datum)

Datum/Uhrzeit

Datum/Uhrzeit

Durch diese Funktion wird der erste Tag der aktuellen Arbeitswoche zurückgegeben. Dabei wird angenommen, dass die Woche mit Montag beginnt. Wenn kein Datum angegeben ist, wird angenommen, dass es sich bei dem Eingabedatum um das heutige Datum handelt.

End_Of_Working_Week(Datum)

Datum/Uhrzeit

Datum/Uhrzeit

Durch diese Funktion wird der letzte Tag einer bestimmten Arbeitswoche zurückgegeben. Dabei wird davon ausgegangen, dass die Arbeitswoche mit Montag beginnt.  Falls das Datum auf ein Wochenende fällt, wird davon ausgegangen, dass der letzte Tag der Arbeitswoche der Tag ist, der 5 oder 6 Tage später liegt.  Wenn kein Datum angegeben ist, wird das heutige Datum verwendet.

End_Of_Current_Month([Eingabedatum])

Datum/Uhrzeit

Datum/Uhrzeit

Diese Funktion gibt das Datum des letzten Tages im jetzigen Monat als Ergebnis für das angegebene <1>Datum<1> zurück.  Wenn kein Datum angegeben ist, wird das heutige Datum als Eingabedatum verwendet.

DateSerial1900(Datum)

Datum/Uhrzeit

Numerisch

Diese Funktion gibt eine Excel-ähnliche Datumsseriennummer für ein angegebenes <1>Datum<1> zurück, und zwar basierend auf dem Datensystem 1900.

DateSerial1904(Datum)

Datum/Uhrzeit

Numerisch

Diese Funktion gibt eine Excel-ähnliche Datumsseriennummer für ein angegebenes <1>Datum<1> zurück, und zwar basierend auf dem Datensystem 1904.

_WorkingDays_ComputeDaysOffInRange (Startdatum;Enddatum)

Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Diese Funktion gibt die Anzahl der arbeitsfreien Tage im Bereich der Datumswerte von<1> Startdatum<1> bis <2>Enddatum<2> zurück. Arbeitsfreie Tage, sind Tage, an denen normalerweise gearbeitet würde, die aber arbeitsfrei sind, weil sie auf einen Feiertag oder einen Urlaubstag fallen. Diese Funktion muss vor der Verwendung der benutzerdefinierten Funktion „Working-Days“ bearbeitet werden.

_WorkingDays_ComputeNormalWorkingDays

InRange(Startdatum;Enddatum)

Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Diese Funktion gibt die Anzahl der normalen Arbeitstage im Bereich der Datumswerte von<1> Startdatum<1> bis <2>Enddatum<2> zurück. Feiertage und Urlaubstage werden nicht berücksichtigt.

_WorkingDays_ComputeWorkingDays

InRange(Startdatum;Enddatum)

Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Diese Funktion gibt die Anzahl der Arbeitstage im Bereich der Datumswerte von<1> Startdatum<1> bis <2>Enddatum<2> zurück. Diese Berechnung berücksichtigt auch Feiertage, die auf Daten fallen, die andernfalls normale Arbeitstage wären.

CountOccurrencesOfWeekdayInRange

(Wochenende;Startdatum;Enddatum)

Numerisch, Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Diese Funktion gibt die Häufigkeit des angegebenen <1>Wochentags<1> (1=Sonntag, 2=Montag, 3=Dienstag, 4=Mittwoch, 5=Freitag, 6=Samstag, 7=Sonntag) im Bereich der Datumswerte von<2> Startdatum<2> bis <3>Enddatum<3> zurück.

DateIsInRange(Datum;Startdatum;Enddatum)

Datum/Uhrzeit, Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Diese Funktion gibt den Wert 1 zurück, wenn sich das angegebene <1>Datum<1> im Bereich der Datumswerte befindet, die mit dem <2>Startdatum<2> beginnen und einen Tag vom dem <3>Enddatum<3> enden. Gibt 0 zurück, wenn das angegebene <1>Datum<1> nicht innerhalb des Bereichs liegt.

_WorkingDays_DateIsWorkingDay

InRange(Datum;Startdatum;Enddatum)

Datum/Uhrzeit, Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Diese Funktion gibt 1 zurück, wenn das angegebene <1>Datum<1> auf einen Arbeitstag im Bereich der Datumswerte von<2> Startdatum<2> bis <3>Enddatum<3> fällt. Anderenfalls gibt sie 0 zurück.

_WorkingDays_FirstValidDateForWorkingDays()

 

Datum/Uhrzeit

Gibt das erste Datum zurück, das für die Verwendung in der Funktion WorkingDays geeignet ist.  Vor der erstmaligen Verwendung der Funktion „WorkingDays“ muss dieser Wert überprüft bzw. bearbeitet werden.

_WorkingDays_IsValidDateRange

ForWorkingDays(Startdatum;Enddatum)

Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Gibt 1 zurück, wenn der Bereich der Datumswerte von <1> Startdatum<1> bis <2>Enddatum<2> für die Funktion „WorkingDays“ geeignet ist. Anderenfalls gibt sie 0 zurück.

_WorkingDays_IsWorkingDay(Wochentag)

Numerisch

Numerisch

Gibt 1 zurück, wenn der angegebene <1>Wochentag<1> (1=Sonntag, 2=Montag, usw.) normalerweise ein Arbeitstag wäre; gibt anderenfalls 0 zurück.  Vor der erstmaligen Verwendung der Funktion „WorkingDays“ muss dieser Wert überprüft bzw. bearbeitet werden. Die Arbeitswoche ist aktuell auf Montag mit Freitag eingestellt.

_WorkingDays_LastValidDateForWorkingDays()

 

Datum/Uhrzeit

Gibt das letzte Datum zurück, das für die Verwendung in der benutzerdefinierten Funktion „WorkingDays“ geeignet ist.  Vor der erstmaligen Verwendung der Funktion „WorkingDays“ muss dieser Wert überprüft bzw. bearbeitet werden.

Weekday_Is_In_Partial_Week (Wochentag;Starttag,Endtag)

Numerisch, Numerisch, Numerisch

 

Gibt 1 zurück, wenn der angegebene <1>Wochentag<1> (1=Sonntag, 2=Montag, usw.) in den Teil der Woche zwischen dem <2>Starttag</2> und dem Tag vor dem <3>Endtag</3> fällt. Anderenfalls gibt sie 0 zurück.

Working_Days(Startdatum;Enddatum)

Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Diese Funktion gibt die Anzahl der Arbeitstage im Bereich der Datumswerte von<1> Startdatum<1> bis <2>Enddatum<2> zurück. Diese Berechnung berücksichtigt auch Feiertage, die auf Daten fallen, die andernfalls normale Arbeitstage sein würden.  Vor Verwendung dieser Funktion müssen Sie unbedingt folgende benutzerdefinierten Funktionen anpassen, und zwar angefangen mit _WorkingDays_: ComputeDaysOffInRange, IsWorkingDay, FirstValidDateForWorkingDays und LastValidDateForWorkingDays.

Qtr_Advanced(Datum;Q1_Start)

Datum/Uhrzeit, Datum/Uhrzeit

Numerisch

Gibt das Quartal (1-4) eines <1>Datums</1> basierend auf <2>einem anderen Startdatum für Quartal 1<2> zurück.  Wenn zum Beispiel das Startdatum für Q1 auf den 1. Oktober 2006 festgelegt wurde, wird für den 31. Januar 2007 Q2 zurückgegeben. Beachten Sie bitte, dass für den Start von Q1 zwar ein vollständiges Datum festgelegt werden muss, das Jahr aber nicht wichtig ist, weil die Funktion für das Eingabedatum über alle Jahre hinweg funktioniert.

Unix_Time_Number_To_Date(Unix-Zeit)

Numerisch

Datum/Uhrzeit

Konvertiert eine <1>Unix- oder Epoch-Zeitangabe<1> auf Basis von UTC in einen Datum/Uhrzeit-Wert. Der Wert für Datum/Uhrzeit ist dabei nur auf die Sekunde genau.  Unix-Zeitwerte, bei denen selbst die Bruchteile einer Sekunde angezeigt sind, werden gerundet.

Date_To_Unix_Time_Number(Datum)

Datum/Uhrzeit

Numerisch

Konvertiert ein <1>UTC-Datum<1> in einen Unix- oder Epoch-Zeitwert. Der Wert für Datum/Uhrzeit ist dabei nur auf die Sekunde genau.