---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideCurrency-Konverter -- Umfang

# GlideCurrency-Konverter -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die GlideCurrency-Konverter 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-Konverter (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 festgelegt werden, bevor aufgerufen wird Konvertieren() Methode zum Durchführen der Währungsumrechnung. Verwenden Sie zum Festlegen des zu konvertierenden Betrags SetAmount() Methode.  
Die Glidewährungskonverter() Die API bietet auch optionale Methoden, mit denen Sie:

* Datum und Uhrzeit festlegen, 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, anstatt der Standard 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](https://www.servicenow.com/docs/access?context=custom-rate-table&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).
{#GlideCurrencyConverterScopedAPI__ul_wx1_qnw_ljb}

Diese Klasse wird ausgeführt in `sn_currency `Namespace.

## GlideCurrency-Konverter -- GlideCurrency-Konverter() {#ariaid-title2}

Instanziiert einen GlideCurrency-Konverter Objekt.
{#Scoped-GCC-GlideCurrConv__table_xzn_5fw_ljb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#Scoped-GCC-GlideCurrConv__table_xzn_5fw_ljb}  
Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

    var conv = new sn_currency.GlideCurrencyConverter();

## GlideCurrency Converter -- GlideCurrency Converter(Zeichenfolge von, Zeichenfolge bis) {#ariaid-title3}

Instanziiert einen GlideCurrency-Konverter Objekt und legt die Quell- und Zielländercodes fest, die bei der Währungsumrechnung verwendet werden sollen.
{#Scoped-GCC-GlideCurrConv_S_S__table_a4p_kjp_cy__entry__3}

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

{#Scoped-GCC-GlideCurrConv_S_S__table_a4p_kjp_cy}  
Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

## GlideCurrency Converter -- Convert() {#ariaid-title4}

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() .
{#Scoped-GCC-convert__table_qyh_2hq_cy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#Scoped-GCC-convert__table_qyh_2hq_cy} {#Scoped-GCC-convert__table_ryh_2hq_cy__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Wenn die Konvertierung erfolgreich ist, wird das Objekt „Currency cyExchangeValue" zurückgegeben. Wenn nicht erfolgreich, wird „null" zurückgegeben. CurrencyExchangeValue { Rate: Number, OriginalAmount: Number, Amount: Number, fromCurrency: String, toCurrency: String, rateSysId: String } Rate: Nummer. In der Umrechnung verwendeter Wechselkurs. OriginalAmount: Nummer. Quellwährungsbetrag. 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 Ratentabellendatensatzes, der zur Berechnung der Umrechnung verwendet wird. |
[Tabelle : 4. Rückgaben]

{#Scoped-GCC-convert__table_ryh_2hq_cy}  
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{Rate = 1.0777, OriginalAmount = 100, Amount = 107.7700, fromCurrency = 'EUR', toCurrency = 'USD', rateSysId = '2ed537fcb271937adb'}

## GlideCurrency-Konverter -- setAmount(Zeichenfolgenbetrag) {#ariaid-title5}

Legt den Betrag der zu konvertierenden Währung fest.
{#Scoped-GCC-setAmount_S__table_pq4_yxp_cy__entry__3}

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

{#Scoped-GCC-setAmount_S__table_pq4_yxp_cy} {#Scoped-GCC-setAmount_S__table_qq4_yxp_cy__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 6. Rückgaben]

{#Scoped-GCC-setAmount_S__table_qq4_yxp_cy}  
Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

## GlideCurrency-Konverter -- setDateTime(Objektdatum) {#ariaid-title6}

Legt Datum und Uhrzeit der Währungsumrechnung fest.
Dieses Datum und diese Uhrzeit bestimmen den Umrechnungskurs, der zum Umrechnen der Währung verwendet wird. Wenn diese Methode nicht vor aufgerufen wird Glidewährungskonverter.Converter() Methode: Die Konvertierung wird anhand der Rate für das aktuelle Datum/die aktuelle Uhrzeit durchgeführt.
{#Scoped-GCC-setDateTime_O__table_zxg_cfc_ljb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Datum | GlideDateTime | Datum/Uhrzeit, für die die Währungsumrechnung berechnet werden soll. Dieser Wert bestimmt den Kurs, der in der Umrechnung verwendet wird. |
[Tabelle : 7. Parameter]

{#Scoped-GCC-setDateTime_O__table_zxg_cfc_ljb} {#Scoped-GCC-setDateTime_O__table_ayg_cfc_ljb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#Scoped-GCC-setDateTime_O__table_ayg_cfc_ljb}  
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-Konverter -- setFromCurrency(Zeichenfolge von) {#ariaid-title7}

Legt den Ländercode der Quellwährung fest.
{#Scoped-GCC-setFromCurrency_S__table_wtv_g5p_cy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| von | Zeichenfolge | Dreistelliger ISO 3166-Ländercode der Quellwährung. |
[Tabelle : 9. Parameter]

{#Scoped-GCC-setFromCurrency_S__table_wtv_g5p_cy} {#Scoped-GCC-setFromCurrency_S__table_xtv_g5p_cy__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 10. Rückgaben]

{#Scoped-GCC-setFromCurrency_S__table_xtv_g5p_cy}  
Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

## GlideCurrency Converter -- setRateTable(Zeichenfolge rateTable) {#ariaid-title8}

Definiert die Kurstabelle, die bei der Währungsumrechnung verwendet werden soll.
Wenn diese Methode nicht vor aufgerufen wird Glidewährungskonverter.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](https://www.servicenow.com/docs/access?context=custom-rate-table&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).
{#Scoped-GCC-setRateTable_S__table_kmn_swp_cy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ratentabelle | Zeichenfolge | Name der Kurstabelle, die in der Währungsumrechnung verwendet werden soll. |
[Tabelle : 11. Parameter]

{#Scoped-GCC-setRateTable_S__table_kmn_swp_cy} {#Scoped-GCC-setRateTable_S__table_lmn_swp_cy__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 12. Rückgaben]

{#Scoped-GCC-setRateTable_S__table_lmn_swp_cy}  
Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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

## GlideCurrency-Konverter -- setToCurrency(Zeichenfolge bis) {#ariaid-title9}

Legt den Ländercode der Zielwährung fest.
{#Scoped-GCC-setToCurrency_S__table_wwy_gwp_cy__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| bis | Zeichenfolge | Dreistelliger ISO 3166-Ländercode der Quellwährung. |
[Tabelle : 13. Parameter]

{#Scoped-GCC-setToCurrency_S__table_wwy_gwp_cy} {#Scoped-GCC-setToCurrency_S__table_xwy_gwp_cy__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 14. Rückgaben]

{#Scoped-GCC-setToCurrency_S__table_xwy_gwp_cy}  
Dieses Beispiel zeigt, wie die Methode aufgerufen wird.

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


