GlideCurrency-Konverter – Umfang

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Die GlideCurrency-Konverter Die API bietet Methoden zum Konvertieren eines Währungswerts in einen anderen, z. B. die Umrechnung von US-Dollar in europäische Euro.

    Sie können das GlideCurrency Converter-Objekt instanziieren und die Quell- und Zielwährungen während der Instanziierung mit definieren GlideCurrency Converter (von, bis) . Sie können das Objekt auch ohne diese Werte instanziieren und später mit definieren SetFromCurrency() Und SetToCurrency() Methoden. Diese Werte und der zu konvertierende Betrag müssen vor dem Aufruf von festgelegt werden Konvertieren () Methode zum Durchführen der Währungsumrechnung. Um den zu konvertierenden Betrag festzulegen, verwenden Sie SetAmount() Methode.

    Die GlideCurrency-Konverter Die API bietet auch optionale Methoden, mit denen Sie:
    • Legen Sie Datum und Uhrzeit fest, für die die Konvertierung durchgeführt werden soll. SetDateTime() . Durch Festlegen des Datums und der Uhrzeit wird bei der Umrechnungsberechnung der Kurs für das angegebene Datum und die angegebene Uhrzeit verwendet, und nicht der Standardwert für das aktuelle Datum und die aktuelle Uhrzeit.
    • Legen Sie die Ratentabelle fest, die bei der Umrechnung verwendet werden soll. 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 Ratentabellen finden Sie unter Fügen Sie Umrechnungskurse mithilfe einer anwenderdefinierten Kurstabelle hinzu .

    Diese API wird in bereitgestellt sn_currency Namespace.

    GlideCurrency Converter: GlideCurrency Converter()

    Instanziiert einen GlideCurrency-Konverter Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter();

    GlideCurrency Converter – GlideCurrency Converter(Zeichenfolge von, Zeichenfolge bis)

    Instanziiert einen GlideCurrency-Konverter 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.

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

    GlideCurrency Converter – convert()

    Führt den Währungsumrechner aus.

    Rufen Sie diese Methode auf, nachdem Sie eine andere aufgerufen haben GlideCurrency-Konverter Methoden, die die Währungsumrechnung erstellen, z. B. SetAmount() , SetRateTable() , Und SetDate() .

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    GlideCurrency-Umtauschwert Objekt GlideCurrency-Umtauschwert Objekt mit Details zur Konvertierung.
    CurrencyExchangeValue{
  fAmount: Number,
  fCurrency: "String",
  fOriginalAmount: Number,
  fOriginalCurrency: "String",
  fRate: Number,
  fRateSysId: "String"
}
    WährungUmtauschwert.fAmount Konvertierter Betrag ( fOriginalAmount* fRate).

    Datentyp: Zahl
    WährungUmtauschwert.fWährung Alphabetischer ISO 4217-Währungscode für die konvertierte Währung.

    Datentyp: Zeichenfolge
    WährungAustauschValue.fOriginalAmount Ursprünglicher Währungsbetrag.

    Datentyp: Zahl
    WährungUmtauschwert.fOriginalWährung Alphabetischer ISO 4217-Währungscode für die ursprüngliche Währung.

    Datentyp: Zeichenfolge
    WährungUmtauschwert.Frate Bei der Umrechnung verwendeter Wechselkurs.

    Datentyp: Zahl
    WährungUmtauschwert.fRateSysId SYS_ID des in der Umrechnung verwendeten Wechselkurses.

    Tabelle: Währungsumrechnungskurs [fx_Conversion_rate]

    Datentyp: Zeichenfolge

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

    Ausgabe:

    CurrencyExchangeValue{fOriginalAmount=100, fOriginalCurrency='EUR', fRate=1.1604, fAmount=116.04, fCurrency='USD', fRateSysId='4555525f5553445f3230323530383036'}

    GlideCurrency Converter – setAmount(Zeichenfolgenbetrag)

    Legt den Betrag der zu konvertierenden Währung fest.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    amount Zeichenfolge Währungsbetrag, der konvertiert werden soll. Dieser Wert muss mit Ausnahme eines Dezimalpunkts unformatiert sein, um die Teilwährung anzugeben. Beispiel: 1234,56 ist gültig, 1.234,56 ist ungültig.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

    GlideCurrency Converter – setDateTime(Objektdatum)

    Legt Datum und Uhrzeit der Währungsumrechnung fest.

    Dieses Datum und diese Uhrzeit bestimmen den Wechselkurs, der zur Umrechnung der Währung verwendet wird. Wenn diese Methode nicht vor aufgerufen wird GlideCurrency Converter.Converter() Methode: Die Konvertierung wird mit der Rate 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'}

    GlideCurrency Converter – setFromCurrency(Zeichenfolge von)

    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

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

    GlideCurrency Converter – setRateTable(String rateTable)

    Definiert die Wechselkurstabelle, die bei der Währungsumrechnung verwendet werden soll.

    Wenn diese Methode nicht vor aufgerufen wird GlideCurrency Converter.Converter() Methode wird aufgerufen, die Konvertierung wird mit der Tabelle „fx_System_rate“ durchgeführt. Alle anwenderdefinierten Ratentabellen müssen die Tabelle „fx_Conversion_rate“ erweitern. Weitere Informationen zum Erstellen von Ratentabellen finden Sie unter Fügen Sie Umrechnungskurse mithilfe einer anwenderdefinierten Kurstabelle hinzu .

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    RateTable Zeichenfolge Name der Kurstabelle, die bei der Währungsumrechnung verwendet werden soll.
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

    GlideCurrency Converter – setToCurrency(Zeichenfolge bis)

    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

    Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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