ບໍລິການ ScriptForge.Region

ບໍລິການ Region ໃຫ້ຄຸນສົມບັດ ແລະ ວິທີການຕ່າງໆເພື່ອຈັດການກ່ຽວກັບທ້ອງຖິ່ນ ແລະ ພາກພື້ນ ເຊັ່ນ:

• ການເຂົ້າເຖິງການຕັ້ງຄ່າທີ່ຂຶ້ນກັບທ້ອງຖິ່ນ ແລະ ພາກພື້ນ ເຊັ່ນ ຮູບແບບຕົວເລກ, ສະກຸນເງິນ ແລະ ເຂດເວລາ.

• ການແປງເຂດເວລາ ແລະ ຄຳນວນຄ່າຊົດເຊີຍເວລາອອມແສງ (DST).

• ການປ່ຽນຕົວເລກໃຫ້ເປັນຂໍ້ຄວາມໃນພາສາໃດກໍໄດ້ທີ່ຮອງຮັບ.

ນິຍາມ

ທ້ອງຖິ່ນ ຫຼື ພາກພື້ນ

ຂໍ້ຄວາມທີ່ລວມພາສາ ແລະ ປະເທດໃນຮູບແບບ "la-CO".

ຕົວຢ່າງ, "en-US" ກົງກັບພາສາອັງກິດໃນສະຫະລັດ; "fr-BE" ກົງກັບພາສາຝຣັ່ງໃນແບນຊິກ, ແລະອື່ນໆ.

ໃນບາງສະຖານະການ ບໍ່ຈຳເປັນຕ້ອງໃຊ້ທ້ອງຖິ່ນແບບເຕັມ ແລະ ສາມາດລະບຸພຽງແຕ່ພາສາ ຫຼື ປະເທດໄດ້.

ຄຸນສົມບັດ ແລະ ວິທີການສ່ວນໃຫຍ່ຮັບທ້ອງຖິ່ນເປັນອາກິວເມັນ. ຖ້າບໍ່ລະບຸ, ຈະໃຊ້ທ້ອງຖິ່ນຂອງສ່ວນຕິດຕໍ່ຜູ້ໃຊ້ ເຊິ່ງກຳນົດໃນ OfficeLocale.

ເຂດເວລາ

ຂໍ້ຄວາມໃນຮູບແບບ "Region/City" ຫຼື ID ເຂດເວລາ ເຊັ່ນ "UTC".

ການລະບຸເຂດເວລາທີ່ບໍ່ຖືກຕ້ອງຈະບໍ່ເຮັດໃຫ້ເກີດຂໍ້ຜິດພາດໃນຂະນະເຮັດວຽກ. ແຕ່ຈະສົ່ງຄືນວັນທີ ແລະ ເວລາປັດຈຸບັນຂອງລະບົບແທນ.

ຄ່າຊົດເຊີຍເວລາລະຫວ່າງເຂດເວລາ ແລະ ເວລາມາດຕະຖານກຣີນິດ (GMT) ແມ່ນສະແດງເປັນນາທີ.

ເວລາອອມແສງ (DST) ແມ່ນຄ່າຊົດເຊີຍເພີ່ມເຕີມ.

ຄ່າຊົດເຊີຍເຂດເວລາ ແລະ DST ອາດຈະເປັນບວກ ຫຼື ລົບກໍໄດ້.

ການເອີ້ນໃຊ້ບໍລິການ

ກ່ອນທີ່ຈະໃຊ້ບໍລິການ Region, ຕ້ອງໂຫລດ ຫຼື ນຳເຂົ້າໄລບຣາຣີ ScriptForge ກ່ອນ:

• ມາໂຄຣ Basic ຕ້ອງມີການໂຫຼດຄັງສຳນວນ ScriptForge ໂດຍໃຊ້ຄຳສັ່ງດັ່ງນີ້:
GlobalScope.BasicLibraries.loadLibrary("ScriptForge")

• ສະຄຣິບ Python ຕ້ອງມີການນຳເຂົ້າຈາກໂມດູນ scriptforge:
from scriptforge import CreateScriptService

ຕົວຢ່າງດ້ານລຸ່ມນີ້ໃນ Basic ແລະ Python ສະແດງການສ້າງອິນສະແຕນຊ໌ບໍລິການ Region ແລະ ເຂົ້າເຖິງຄຸນສົມບັດ Country.

    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"))
  

ຄຸນສົມບັດ

ຄຸນສົມບັດທັງໝົດທີ່ລະບຸດ້ານລຸ່ມນີ້ຮັບອາກິວເມັນ locale ເປັນຂໍ້ຄວາມ.

DSTOffset

ຄຳນວນຄ່າຊົດເຊີຍເວລາອອມແສງ (DST) ເພີ່ມເຕີມເປັນນາທີ.

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

localdatetime: ວັນທີ ແລະ ເວລາທ້ອງຖິ່ນ.

timezone: ເຂດເວລາທີ່ຈະໃຊ້ຄຳນວນຄ່າຊົດເຊີຍ.

locale: ທ້ອງຖິ່ນທີ່ລະບຸປະເທດທີ່ຈະໃຊ້ຄຳນວນຄ່າຊົດເຊີຍ.

      ' ຄຳນວນຄ່າຊົດເຊີຍໃນເຂດເວລາ "America/Los_Angeles"
      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 (minutes)
      aDateTime = DateSerial(2022, 1, 1) + TimeSerial(16, 0, 0)
      offset = oRegion.DSTOffset(aDateTime, "America/Los_Angeles", "US") ' 0 (minutes)
    

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

LocalDateTime

ຄຳນວນວັນທີ ແລະ ເວລາທ້ອງຖິ່ນຈາກວັນທີ ແລະ ເວລາ UTC.

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

utcdatetime: ວັນທີ ແລະ ເວລາ UTC.

timezone: ເຂດເວລາທີ່ຈະໃຊ້ຄຳນວນເວລາທ້ອງຖິ່ນ.

locale: ທ້ອງຖິ່ນທີ່ລະບຸປະເທດທີ່ຈະໃຊ້ຄຳນວນເວລາທ້ອງຖິ່ນ.

      ' ວັນທີ 6 ມິຖຸນາ 2022 ເວລາ 10:30:45 (ໃຊ້ເປັນເວລາ UTC ຢູ່ບ່ອນນີ້)
      Dim UTCTime As Date, localTime As Date
      UTCTime = DateSerial(2022, 6, 23) + TimeSerial(10, 30, 45)
      ' ຄຳນວນເວລາທ້ອງຖິ່ນໃນ ເຊົາເປົາໂລ, ບຣາຊິລ
      ' ວັນທີ 6 ມິຖຸນາ 2022 ເວລາ 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")
    

Number2Text

ປ່ຽນຕົວເລກ ແລະ ຄ່າເງິນໃຫ້ເປັນຂໍ້ຄວາມຂຽນ ສຳລັບພາສາໃດໜຶ່ງທີ່ຮອງຮັບໃນປັດຈຸບັນ.

ເບິ່ງລາຍຊື່ພາສາທີ່ຮອງຮັບທັງໝົດໄດ້ທີ່ XNumberText Interface.

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

number: ຕົວເລກທີ່ຈະປ່ຽນເປັນຂໍ້ຄວາມຂຽນ.

locale: ທ້ອງຖິ່ນທີ່ກຳນົດພາສາທີ່ຈະໃຊ້ແປງຕົວເລກ.

      ' ສົ່ງຄືນ "one hundred five"
      Dim numText As String
      numText = oRegion.Number2Text(105, "en-US")
      ' ສົ່ງຄືນ: "two point four two"
      numText = oRegion.Number2Text(2.42, "en-US")
      ' ສົ່ງຄືນ: "twenty-five euro and ten cents"
      numText = oRegion.Number2Text("EUR 25.10", "en-US")
      ' ສົ່ງຄືນ: "fifteenth"
      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")
    

ເພື່ອເບິ່ງລາຍຊື່ຄຳນຳໜ້າທີ່ຮອງຮັບທັງໝົດໃນພາສາໃດໜຶ່ງ, ໃຫ້ເອີ້ນ Number2Text ດ້ວຍອາກິວເມັນພິເສດ "help".

      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
    

ແຖວທຳອິດໃນກ່ອງຂໍ້ຄວາມຈະບໍ່ມີຄຳນຳໜ້າ, ເຊິ່ງໝາຍຄວາມວ່າມັນເປັນຮູບແບບມາດຕະຖານ.

ແຕ່ລະພາສາມີຊຸດຄຳນຳໜ້າທີ່ຮອງຮັບຂອງຕົນເອງ. ຈຳນວນຄຳນຳໜ້າທີ່ມີຢູ່ນັ້ນອາດແຕກຕ່າງກັນໄປຕາມແຕ່ລະພາສາ.

ເພື່ອເບິ່ງລາຍຊື່ຄຳນຳໜ້າສຳລັບພາສາ ຫຼື ທ້ອງຖິ່ນໃດໜຶ່ງ, ສາມາດລະບຸເປັນອາກິວເມັນທີສອງໃນ Number2Text ໄດ້.

      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

ສົ່ງຄືນຄ່າຊົດເຊີຍລະຫວ່າງ GMT ແລະ ເຂດເວລາທີ່ລະບຸ ເປັນນາທີ.

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

timezone: ເຂດເວລາທີ່ຈະໃຊ້ຄຳນວນຄ່າຊົດເຊີຍທຽບກັບ GMT.

locale: ທ້ອງຖິ່ນທີ່ລະບຸປະເທດທີ່ຈະໃຊ້ຄຳນວນຄ່າຊົດເຊີຍ.

      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
    

UTCDateTime

ສົ່ງຄືນວັນທີ ແລະ ເວລາ UTC ໂດຍພິຈາລະນາຈາກວັນທີ ແລະ ເວລາທ້ອງຖິ່ນໃນເຂດເວລາທີ່ລະບຸ.

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

localdatetime: ວັນທີ ແລະ ເວລາທ້ອງຖິ່ນໃນເຂດເວລາສະເພາະ.

timezone: ເຂດເວລາຂອງອາກິວເມັນ localdatetime ທີ່ລະບຸ.

locale: ທ້ອງຖິ່ນທີ່ລະບຸປະເທດຂອງອາກິວເມັນ localdatetime ທີ່ລະບຸ.

      ' ວັນທີ/ເວລາ ໃນເບີລິນ, 23 ມິຖຸນາ 2022 ເວລາ 14:30:00
      Dim localDT As Date, utcTime As Date
      localDT = DateSerial(2022, 6, 23) + TimeSerial(14, 30, 0)
      ' ວັນທີ/ເວລາ UTC ແມ່ນ 23 ມິຖຸນາ 2022 ເວລາ 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")
    

UTCNow

ສົ່ງຄືນວັນທີ ແລະ ເວລາ UTC ປັດຈຸບັນ.

ວິທີການນີ້ໃຊ້ວັນທີ ແລະ ເວລາປັດຈຸບັນຂອງລະບົບປະຕິບັດການຂອງທ່ານເພື່ອຄຳນວນເວລາ UTC.

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

timezone: ເຂດເວລາທີ່ຈະໃຊ້ຄິດໄລ່ເວລາ UTC ປັດຈຸບັນ.

locale: ໂລແຄລ (ການກຳນົດທ້ອງຖິ່ນ) ທີ່ລະບຸປະເທດທີ່ຈະໃຊ້ຄິດໄລ່ເວລາ UTC ປັດຈຸບັນ, ໂດຍໃຫ້ມາໃນຮູບແບບ "la-CO" ຫຼື "CO". ຄ່າເລີ່ມຕົ້ນແມ່ນໂລແຄລທີ່ກຳນົດໄວ້ໃນຄຸນສົມບັດ OfficeLocale ຂອງບໍລິການ Platform.

      ' ສົມມຸດວ່າເວລາຂອງລະບົບປະຕິບັດການແມ່ນ ວັນທີ 23 ມິຖຸນາ 2022 ເວລາ 10:42:00
      ' ຖ້າຄອມພິວເຕີຢູ່ໃນ Europe/Berlin, ເວລາ UTC ຈະແມ່ນ ວັນທີ 23 ມິຖຸນາ 2022 ເວລາ 08:42:00
      Dim utcTime As Date
      utcTime = oRegion.UTCNow("Europe/Berlin", "DE")
    

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