ScriptForge . Rehiyon serbisyo

Ang Rehiyon Nagbibigay ang serbisyo ng isang koleksyon ng mga katangian at pamamaraan upang mahawakan ang mga aspeto ng programming na nauugnay sa lokal at rehiyon, tulad ng:

Mga Kahulugan

Lokal o Rehiyon

Isang string na pinagsasama ang isang wika at isang bansa sa format na "la-CO". Ang bahagi ng wika ay ipinahayag na may 2 o 3 lowercase na character na sinusundan ng isang gitling at 2 uppercase na character na kumakatawan sa bansa.

Halimbawa, ang "en-US" ay tumutugma sa wikang Ingles sa United States; Ang "fr-BE" ay tumutugma sa wikang Pranses sa Belgium, at iba pa.

Sa ilang sitwasyon, hindi kinakailangan ang buong lokal at tanging wika o bansa lamang ang maaaring tukuyin.

note

Karamihan sa mga katangian at pamamaraan ay tumatanggap ng isang lokal bilang argumento. Kung walang tinukoy na lokal, gagamitin ang lokal na user-interface, na tinukoy sa OfficeLocale ari-arian ng Plataporma serbisyo.


Timezone

Isang string sa format na "Rehiyon/City" gaya ng "Europe/Berlin", o isang timezone ID gaya ng "UTC" o "GMT-8:00". Sumangguni sa pahina ng wiki Listahan ng mga timezone ng tz database para sa isang listahan ng mga posibleng pangalan at ID ng timezone.

warning

Pagbibigay ng di-wastong string ng timezone sa alinman sa mga pamamaraan sa Rehiyon serbisyo ay hindi magreresulta sa isang runtime error. Sa halip, mga pamamaraan bilang UTCDateTime at UTCNow ibabalik ang kasalukuyang petsa at oras ng operating system.


Ang time offset sa pagitan ng timezone at Greenwich Meridian Time (GMT) ay ipinahayag sa minuto.

Ang Daylight Saving Time (DST) ay isang karagdagang offset.

note

Ang timezone at mga DST offset ay maaaring positibo o negatibo.


Panawagan sa serbisyo

Bago gamitin ang Rehiyon serbisyo ang ScriptForge kailangang i-load o i-import ang library:

note

‱ Ang mga pangunahing macro ay kailangang mag-load ScriptForge aklatan gamit ang sumusunod na pahayag:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

‱ Ang mga script ng Python ay nangangailangan ng pag-import mula sa scriptforge module:
mula sa scriptforge import CreateScriptService


Ang mga halimbawa sa ibaba sa Basic at Python ay nagpapakita ng Rehiyon serbisyo at i-access ang Bansa ari-arian.

Sa Basic

    GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
    Dim oRegion As Variant
    oRegion = CreateScriptService("Region")
    MsgBox oRegion.Country("en-US") ' United States
Sa Python

    from scriptforge import CreateScriptService
    oRregion = CreateScriptService("Region")
    bas = CreateScriptService("Basic")
    bas.MsgBox(oRegion.Country("en-US"))

Mga Katangian

Lahat ng property na nakalista sa ibaba ay tumatanggap ng a lokal argumento, na ibinigay bilang isang string. Ang ilang mga katangian ay nangangailangan ng argument na ito na nasa format na "la-CO", samantalang ang iba ay maaaring makatanggap ng "la" o "CO" bilang input.

Pangalan

Readonly

Type

Lokal

Mga nilalaman

Country

Mayroon

String

"la‑CO"
"CO"

Ibinabalik ang pangalan ng bansa sa English na tumutugma sa isang partikular na rehiyon.

Currency

Mayroon

String

"la-CO"
"CO"

Ibinabalik ang ISO 4217 currency code ng tinukoy na rehiyon.

DatePatterns

Mayroon

String array

"la-CO"

Nagbabalik ng zero-based na hanay ng mga string na naglalaman ng mga pattern ng pagtanggap ng petsa para sa tinukoy na rehiyon.

DateSeparator

Mayroon

String

"la-CO"

Ibinabalik ang separator ng petsa na ginamit sa ibinigay na rehiyon.

DayAbbrevNames

Mayroon

String array

"la-CO"
"la"

Nagbabalik ng zero-based na hanay ng mga string na naglalaman ng listahan ng mga dinaglat na pangalan ng weekday sa tinukoy na wika.

DayNames

Mayroon

String array

"la-CO"
"la"

Nagbabalik ng zero-based na hanay ng mga string na naglalaman ng listahan ng mga pangalan ng karaniwang araw sa tinukoy na wika.

DayNarrowNames

Mayroon

String array

"la-CO"
"la"

Nagbabalik ng zero-based na hanay ng mga string na naglalaman ng listahan ng mga inisyal ng mga pangalan ng karaniwang araw sa tinukoy na wika.

DecimalPoint

Mayroon

String

"la-CO"

Ibinabalik ang decimal separator na ginamit sa mga numero sa tinukoy na rehiyon.

Language

Mayroon

String

"la-CO"
"la"

Ibinabalik ang pangalan ng wika, sa English, ng tinukoy na rehiyon.

ListSeparator

Mayroon

String

"la-CO"

Ibinabalik ang list separator na ginamit sa tinukoy na rehiyon.

MonthAbbrevNames

Mayroon

String array

"la-CO"
"la"

Nagbabalik ng zero-based na array ng mga string na naglalaman ng listahan ng mga pinaikling pangalan ng buwan sa tinukoy na wika.

MonthNames

Mayroon

String array

"la-CO"
"la"

Nagbabalik ng zero-based na hanay ng mga string na naglalaman ng listahan ng mga pangalan ng buwan sa tinukoy na wika.

MonthNarrowNames

Mayroon

String array

"la-CO"
"la"

Nagbabalik ng zero-based na hanay ng mga string na naglalaman ng listahan ng mga inisyal ng mga pangalan ng buwan sa tinukoy na wika.

ThousandSeparator

Mayroon

String

"la-CO"

Ibinabalik ang libu-libong separator na ginamit sa mga numero sa tinukoy na rehiyon.

TimeSeparator

Mayroon

String

"la-CO"

Ibinabalik ang separator na ginamit sa pag-format ng mga oras sa tinukoy na rehiyon.

Listahan ng mga Paraan sa Serbisyo ng Rehiyon

DSTOffset
LocalDateTime

Number2Text
TimeZoneOffset

UTCDateTime
UTCNow

DSTOffset

Kinakalkula ang karagdagang Daylight Saving Time (DST) offset, sa ilang minuto, na naaangkop sa isang partikular na rehiyon at timezone.

Syntax:

svc.DSTOffset(localdatetime: date, timezone: str, opt locale: str): int

Mga Parameter:

localdatetime : ang lokal na petsa at oras na ipinahayag bilang isang petsa.

timezone : ang timezone kung saan kakalkulahin ang offset.

lokal : ang lokal na tumutukoy sa bansa kung saan kakalkulahin ang offset, na ibinigay sa alinman sa "la-CO" o "CO" na mga format. Ang default na halaga ay ang lokal na tinukoy sa OfficeLocale ari-arian ng Plataporma serbisyo.

Halimbawa:

Sa Basic

      ' Kinakalkula ang offset na naaangkop sa "America/Los_Angeles" na timezone
      Dim aDateTime As Date, offset As Integer
      aDateTime = DateSerial(2022, 7, 1) + TimeSerial(16, 0, 0)
      offset = oRegion.DSTOffset(aDateTime, "America/Los_Angeles", "US") ' 60 (minuto)
      aDateTime = DateSerial(2022, 1, 1) + TimeSerial(16, 0, 0)
      offset = oRegion.DSTOffset(aDateTime, "America/Los_Angeles", "US") ' 0 (minuto)
Sa Python

      import datetime
      aDateTime = datetime.datetime(2022, 7, 1, 16, 0, 0)
      offset = oRegion.DSTOffset(aDateTime, "America/Los_Angeles", "US") ' 60 (minuto)
      aDateTime = datetime.datetime(2022, 1, 1, 16, 0, 0)
      offset = oRegion.DSTOffset(aDateTime, "America/Los_Angeles", "US") ' 0 (minuto)

LocalDateTime

Kinakalkula ang lokal na petsa at oras mula sa isang petsa at oras ng UTC.

Syntax:

svc.LocalDateTime(utcdatetime: date, timezone: str, opt locale: str): date

Mga Parameter:

utcdatetime : ang petsa at oras ng UTC, na ipinahayag gamit ang object ng petsa.

timezone : ang timezone kung saan kakalkulahin ang lokal na oras.

lokal : ang lokal na tumutukoy sa bansa kung saan kakalkulahin ang lokal na oras, na ibinigay sa alinman sa "la-CO" o "CO" na mga format. Ang default na halaga ay ang lokal na tinukoy sa OfficeLocale ari-arian ng Plataporma serbisyo.

Halimbawa:

Sa Basic

      ' Hunyo 6, 2022 nang 10:30:45 (ginamit dito bilang oras ng UTC)
      Dim UTCTime As Date, localTime As Date
      UTCTime = DateSerial(2022, 6, 23) + TimeSerial(10, 30, 45)
      ' Kinakalkula ang lokal na oras sa Sao Paulo, Brazil
      ' Hunyo 6, 2022 nang 07:30:45
      localTime = oRegion.LocalDateTime(UTCTime, "America/Sao_Paulo", "BR")
Sa Python

      import datetime
      utcTime = datetime.datetime(2022, 6, 23, 10, 30, 45)
      localTime = oRegion.LocalDateTime(utcTime, "America/Sao_Paulo", "BR")

Number2Text

Kino-convert ang mga numero at halaga ng pera sa nakasulat na teksto para sa alinman sa mga kasalukuyang sinusuportahang wika.

tip

Para sa isang listahan ng lahat ng sinusuportahang wika bisitahin ang XNumberText Interface Sanggunian ng API.


Syntax:

svc.Number2Text(number: any, opt locale: str): str

Mga Parameter:

numero : ang numerong iko-convert sa nakasulat na teksto. Maaari itong ibigay bilang isang uri ng numero o bilang isang string. Kapag may ibinigay na string, maaari itong unahan ng prefix na nagpapaalam kung paano dapat isulat ang mga numero. Posible ring isama ang ISO 4217 currency code. Tingnan ang mga halimbawa sa ibaba para sa higit pang impormasyon.

lokal : ang lokal na tumutukoy sa wika kung saan iko-convert ang numero, na ibinigay sa alinman sa "la-CO" o "la" na mga format. Ang default na halaga ay ang lokal na tinukoy sa OfficeLocale ari-arian ng Plataporma serbisyo.

Halimbawa:

Sa Basic

      ' Nagbabalik ng "isang daan lima"
      Dim numText As String
      numText = oRegion.Number2Text(105, "en-US")
      ' Pagbabalik: "two point four two"
      numText = oRegion.Number2Text(2.42, "en-US")
      ' Ibinabalik: "dalawampu't limang euro at sampung sentimo" Pansinin ang simbolo ng pera na "EUR"
      numText = oRegion.Number2Text("EUR 25.10", "en-US")
      ' Nagbabalik: "ikalabing limang"; Pansinin ang prefix na "ordinal".
      numText = oRegion.Number2Text("ordinal 15", "en-US")
Sa Python

      numText = oRegion.Number2Text(105, "en-US")
      numText = oRegion.Number2Text(2.42, "en-US")
      numText = oRegion.Number2Text("EUR 25.10", "en-US")
      numText = oRegion.Number2Text("ordinal 15", "en-US")

Upang makakuha ng listahan ng lahat ng sinusuportahang prefix sa isang partikular na wika, tumawag Numero 2 Teksto na may espesyal na argumentong "tulong". Sa halimbawa sa ibaba, ipagpalagay na ang iyong lokal ay nakatakda sa "en-US", pagkatapos ay ang listahan ng mga available na prefix para sa "en-US" ay ipapakita ng MsgBox :


      prefixes = oRegion.Number2Text("help")
      MsgBox prefixes
      ' one, two, three
      ' ordinal: first, second, third
      ' ordinal-number: 1st, 2nd, 3rd
      ' year: nineteen ninety-nine, two thousand, two thousand one
      ' currency (for example, USD): two U.S. dollars and fifty cents
      ' money USD: two and 50/100 U.S. dollars

Ang unang linya sa kahon ng mensahe ay walang prefix, na nangangahulugang ito ang karaniwang format. Kasama sa mga kasunod na linya ang prefix at ilang halimbawa ng mga numero gamit ang format nito.

note

Ang bawat wika ay may sariling hanay ng mga sinusuportahang prefix. Maaaring mag-iba ang bilang ng mga magagamit na prefix sa bawat wika.


Upang makuha ang listahan ng mga prefix para sa isang partikular na wika o lokal, maaari itong tukuyin bilang pangalawang argumento sa Numero 2 Teksto . Ipinapakita ng halimbawa sa ibaba ang mga available na prefix na available para sa lokal na "pt-BR":


      prefixes = oRegion.Number2Text("help", "pt-BR")
      MsgBox prefixes
      ' um, dois, trĂȘs
      ' feminine: uma, duas, trĂȘs
      ' masculine: um, dois, trĂȘs
      ' ordinal-feminine: primeira, segunda, terceira
      ' ordinal-masculine: primeiro, segundo, terceiro
      ' ordinal-number-feminine: 1.ÂȘ, 2.ÂȘ, 3.ÂȘ
      ' ordinal-number-masculine: 1.Âș, 2.Âș, 3.Âș

TimeZoneOffset

Ibinabalik ang offset sa pagitan ng GMT at ang ibinigay na timezone at lokal, sa ilang minuto.

Syntax:

svc.TimeZoneOffset(timezone: str, opt locale: str): int

Mga Parameter:

timezone : ang timezone kung saan kakalkulahin ang offset sa GMT.

lokal : ang lokal na tumutukoy sa bansa kung saan kakalkulahin ang offset, na ibinigay sa alinman sa "la-CO" o "CO" na mga format. Ang default na halaga ay ang lokal na tinukoy sa OfficeLocale ari-arian ng Plataporma serbisyo.

Halimbawa:

Sa Basic

      Dim offset As Integer
      offset = oRegion.TimeZoneOffset("America/New_York", "US") ' -300
      offset = oRegion.TimeZoneOffset("Europe/Berlin", "DE") ' 60
Sa Python

      offset = oRegion.TimeZoneOffset("America/New_York", "US") # -300
      offset = oRegion.TimeZoneOffset("Europe/Berlin", "DE") # 60

UTCDateTime

Ibinabalik ang petsa at oras ng UTC na isinasaalang-alang ang ibinigay na lokal na petsa at oras sa isang timezone.

Syntax:

svc.UTCDateTime(localdatetime: date, timezone: str, opt locale: str): date

Mga Parameter:

localdatetime : ang lokal na petsa at oras sa isang partikular na timezone na ipinahayag bilang isang petsa.

timezone : ang timezone kung saan ang localdatetime ibinigay ang argumento.

lokal : ang lokal na tumutukoy sa bansa kung saan ang localdatetime ibinigay ang argumento, na ipinahayag sa alinman sa "la-CO" o "CO" na mga format. Ang default na halaga ay ang lokal na tinukoy sa OfficeLocale ari-arian ng Plataporma serbisyo.

Halimbawa:

Sa Basic

      ' Petsa/Oras sa Berlin, Hunyo 23, 2022 nang 14:30:00
      Dim localDT As Date, utcTime As Date
      localDT = DateSerial(2022, 6, 23) + TimeSerial(14, 30, 0)
      ' Ang petsa/oras ng UTC ay Hunyo 23, 2022 nang 12:30:00
      utcTime = oRegion.UTCDateTime(localDT, "Europe/Berlin", "DE")
Sa Python

      import datetime
      localDT = datetime.datetime(2022, 6, 23, 14, 30, 0)
      utcTime = oRegion.UTCDateTime(localDT, "Europe/Berlin", "DE")

UTCNow

Ibinabalik ang kasalukuyang petsa at oras ng UTC, na binigyan ng timezone at lokal.

Ginagamit ng paraang ito ang kasalukuyang petsa at oras ng iyong operating system upang kalkulahin ang oras ng UTC.

Syntax:

svc.UTCNow(timezone: str, opt locale: str): date

Mga Parameter:

timezone : ang timezone kung saan kakalkulahin ang kasalukuyang oras ng UTC.

lokal : ang lokal na tumutukoy sa bansa kung saan kakalkulahin ang kasalukuyang oras ng UTC, na ibinigay sa alinman sa "la-CO" o "CO" na mga format. Ang default na halaga ay ang lokal na tinukoy sa OfficeLocale ari-arian ng Plataporma serbisyo.

Halimbawa:

Sa Basic

      ' Ipagpalagay na ang oras ng operating system ay Hunyo 23, 2022 nang 10:42:00
      ' Kung ang computer ay nasa Europe/Berlin, ang oras ng UTC ay Hunyo 23, 2022 nang 08:42:00
      Dim utcTime As Date
      utcTime = oRegion.UTCNow("Europe/Berlin", "DE")
Sa Python

      utcTime = oRegion.UTCNow("Europe/Berlin", "DE")

Mga Kaugnay na Paksa

ScriptForge . Plataporma serbisyo

Mangyaring suportahan kami!