Tulong sa LibreOffice 25.8
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:
Pag-access sa mga setting ng lokal at nakadepende sa rehiyon gaya ng pag-format ng numero, pera at mga timezone.
Kino-convert ang mga timezone at kalkulahin ang mga offset ng Daylight Saving Time (DST).
Pagbabago ng mga numero sa teksto sa anumang sinusuportahang wika.
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.
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.
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.
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.
Ang timezone at mga DST offset ay maaaring positibo o negatibo.
Bago gamitin ang Rehiyon serbisyo ang ScriptForge kailangang i-load o i-import ang library:
Ang mga halimbawa sa ibaba sa Basic at Python ay nagpapakita ng Rehiyon serbisyo at i-access ang Bansa ari-arian.
    GlobalScope.BasicLibraries.LoadLibrary("ScriptForge")
    Dim oRegion As Variant
    oRegion = CreateScriptService("Region")
    MsgBox oRegion.Country("en-US") ' United States
  
    from scriptforge import CreateScriptService
    oRregion = CreateScriptService("Region")
    bas = CreateScriptService("Basic")
    bas.MsgBox(oRegion.Country("en-US"))
  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" | Ibinabalik ang pangalan ng bansa sa English na tumutugma sa isang partikular na rehiyon. | 
| Currency | Mayroon | String | "la-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" | 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" | 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" | 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" | 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" | 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" | 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" | 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 | ||
|---|---|---|
Kinakalkula ang karagdagang Daylight Saving Time (DST) offset, sa ilang minuto, na naaangkop sa isang partikular na rehiyon at timezone.
svc.DSTOffset(localdatetime: date, timezone: str, opt locale: str): int
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.
      ' 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)
    
      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)
    Kinakalkula ang lokal na petsa at oras mula sa isang petsa at oras ng UTC.
svc.LocalDateTime(utcdatetime: date, timezone: str, opt locale: str): date
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.
      ' 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")
    
      import datetime
      utcTime = datetime.datetime(2022, 6, 23, 10, 30, 45)
      localTime = oRegion.LocalDateTime(utcTime, "America/Sao_Paulo", "BR")
    Kino-convert ang mga numero at halaga ng pera sa nakasulat na teksto para sa alinman sa mga kasalukuyang sinusuportahang wika.
Para sa isang listahan ng lahat ng sinusuportahang wika bisitahin ang XNumberText Interface Sanggunian ng API.
svc.Number2Text(number: any, opt locale: str): str
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.
      ' 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")
    
      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.
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.º
    Ibinabalik ang offset sa pagitan ng GMT at ang ibinigay na timezone at lokal, sa ilang minuto.
svc.TimeZoneOffset(timezone: str, opt locale: str): int
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.
      Dim offset As Integer
      offset = oRegion.TimeZoneOffset("America/New_York", "US") ' -300
      offset = oRegion.TimeZoneOffset("Europe/Berlin", "DE") ' 60
    
      offset = oRegion.TimeZoneOffset("America/New_York", "US") # -300
      offset = oRegion.TimeZoneOffset("Europe/Berlin", "DE") # 60
    Ibinabalik ang petsa at oras ng UTC na isinasaalang-alang ang ibinigay na lokal na petsa at oras sa isang timezone.
svc.UTCDateTime(localdatetime: date, timezone: str, opt locale: str): date
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.
      ' 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")
    
      import datetime
      localDT = datetime.datetime(2022, 6, 23, 14, 30, 0)
      utcTime = oRegion.UTCDateTime(localDT, "Europe/Berlin", "DE")
    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.
svc.UTCNow(timezone: str, opt locale: str): date
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.
      ' 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")
    
      utcTime = oRegion.UTCNow("Europe/Berlin", "DE")