GlideCurrencyConverter : Bereichsbezogen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Die GlideCurrencyConverter -API bietet Methoden zum Konvertieren eines Währungswerts in einen anderen, z. B. zum Konvertieren von US-Dollar in Euro.

    Sie können das GlideCurrencyConverter-Objekt instanziieren und die Quell- und Zielwährungen während der Instanziierung mit GlideCurrencyConverter(from, to)definieren. Sie können das Objekt auch ohne diese Werte instanziieren und später mit den Methoden „setFromCurrency()“ und „setToCurrency()“ definieren. Diese Werte und der zu konvertierende Betrag müssen vor dem Aufrufen der konvertieren () -Methode festgelegt werden, um die Währungsumrechnung durchzuführen. Um den umzuwandelnden Betrag festzulegen, verwenden Sie die Methode setAmount().

    Die GlideCurrencyConverter() -API bietet auch optionale Methoden, mit denen Sie:
    • Legen Sie Datum und Uhrzeit für die Konvertierung fest: setDateTime(). Durch Festlegen von Datum und Uhrzeit wird bei der Umrechnungsberechnung der für das angegebene Datum und die angegebene Uhrzeit verwendete Kurs anstelle des Standardwerts für das aktuelle Datum und die aktuelle Uhrzeit verwendet.
    • Legen Sie die für die Konvertierung zu verwendende Ratentabelle fest: setRateTable(). Standardmäßig verwendet die Konvertierung die Tabelle „fx_system_rate“. Sie können jedoch anwenderdefinierte Ratentabellen für Ihre Instanz definieren. Weitere Informationen zum Erstellen von Kurstabellen finden Sie unter Wechselkurse mithilfe einer anwenderdefinierten Kurstabelle hinzufügen.

    Diese Klasse wird im Namespace sn_currency ausgeführt.

    GlideCurrencyConverter: GlideCurrencyConverter()

    Instanziiert ein GlideCurrencyConverter -Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter();

    GlideCurrencyConverter: GlideCurrencyConverter(String from, String to)

    Instanziiert ein GlideCurrencyConverter -Objekt und legt die Quell- und Zielländercodes fest, die bei der Währungsumrechnung verwendet werden sollen.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    from Zeichenfolge Dreistelliger ISO 3166-Ländercode der Quellwährung.
    bis Zeichenfolge Dreistelliger ISO 3166-Ländercode der konvertierten Währung.

    In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');

    GlideCurrencyConverter – konvertieren ()

    Führt den Währungsumrechner aus.

    Rufen Sie diese Methode auf, nachdem Sie andere GlideCurrencyConverter -Methoden aufgerufen haben, die die Währungsumrechnung erstellen, z. B. setAmount(), setRateTable()und setDate().

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Objekt Wenn die Konvertierung erfolgreich ist, wird das CurrencyExchangeValue-Objekt zurückgegeben. Wenn dies nicht erfolgreich ist, wird „null“ zurückgegeben.
    CurrencyExchangeValue {
Rate: Number,
OriginalAmount: Number,
Amount: Number,
fromCurrency: String,
toCurrency: String,
rateSysId: String
}

    Rate: Nummer. Bei der Umrechnung verwendeter Wechselkurs.

    OriginalAmount: Nummer. Betrag in Quellwährung.

    Amount: Nummer. Konvertierter Betrag (OriginalAmount * Rate).

    fromCurrency: Zeichenfolge. Dreistelliger ISO 3166-Ländercode der Quellwährung.

    toCurrency: Zeichenfolge. Dreistelliger ISO 3166-Ländercode der konvertierten Währung.

    rateSysId: Zeichenfolge. Sys_id des Ratentabellen-Datensatzes, der zur Berechnung der Umrechnung verwendet wird.

    In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);
gs.info(conv.convert());

    Ausgabe:

    CurrencyExchangeValue{Rate = 1.0777, OriginalAmount = 100, Amount = 107.7700, fromCurrency = 'EUR', toCurrency = 'USD', rateSysId = '2ed537fcb271937adb'}

    GlideCurrencyConverter – setAmount(Zeichenfolgebetrag)

    Legt den zu konvertierenden Währungsbetrag fest.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    amount Zeichenfolge Zu konvertierender Währungsbetrag. Dieser Wert muss bis auf einen Dezimalpunkt unformatiert sein, um eine Teilwährung anzugeben. Beispiel: 1234.56 ist gültig, 1.234.56 ist ungültig.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    void

    In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);

    GlideCurrencyConverter - setDateTime(Object date)

    Legt Datum und Uhrzeit der Währungsumrechnung fest.

    Dieses Datum und diese Uhrzeit bestimmen den Wechselkurs, der zum Umrechnen der Währung verwendet wird. Wenn diese Methode nicht vor der Methode „GlideCurrencyConverter.convert()“ aufgerufen wird, wird die Konvertierung anhand des Kurses für das aktuelle Datum/die aktuelle Uhrzeit durchgeführt.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Datum GlideDateTime Datum/Uhrzeit, für die die Währungsumrechnung berechnet werden soll. Dieser Wert bestimmt den Kurs, der bei der Umrechnung verwendet wird.
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    void

    Das folgende Beispiel zeigt, wie diese Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setAmount(100);
var gd = new GlideDateTime("2019-01-03 11:00:00");
conv.setDateTime(gd);
gs.info(conv.convert());

    Ausgabe:

    CurrencyExchangeValue{fOriginalAmount=100, fOriginalCurrency='EUR', fRate=1.061, fAmount=106.1, fCurrency='USD', fRateSysId='4555525f5553445f3130303030313031'}

    GlideCurrencyConverter – setFromCurrency(String from)

    Legt den Ländercode der Quellwährung fest.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    from Zeichenfolge Dreistelliger ISO 3166-Ländercode der Quellwährung.
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    void

    In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter().setFromCurrency('FRA');

    GlideCurrencyConverter - setRateTable(String RateTable)

    Definiert die Kurstabelle für die Währungsumrechnung.

    Wenn diese Methode nicht vor dem Aufruf der Methode GlideCurrencyConverter.convert() aufgerufen wird, wird die Konvertierung mithilfe der Tabelle „fx_system_rate“ durchgeführt. Alle anwenderdefinierten Ratentabellen müssen die Tabelle „fx_conversion_rate“ erweitern. Weitere Informationen zum Erstellen von Kurstabellen finden Sie unter Wechselkurse mithilfe einer anwenderdefinierten Kurstabelle hinzufügen.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    RateTable Zeichenfolge Name der Kurstabelle für die Währungsumrechnung.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    void

    In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter('EUR', 'USD');
conv.setRateTable(custom_rate_table);

    GlideCurrencyConverter – setToCurrency(String to)

    Legt den Ländercode der Zielwährung fest.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    to Zeichenfolge Dreistelliger ISO 3166-Ländercode der Quellwährung.
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    void

    In diesem Beispiel wird gezeigt, wie die -Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter().setToCurrency('USA');