ເນື້ອໃນ

# ການແປງຄ່າວັນທີ

ຟັງຊັນຕໍ່ໄປນີ້ໃຊ້ສຳລັບແປງຄ່າວັນທີໃຫ້ເປັນຕົວເລກທີ່ສາມາດຄຳນວນໄດ້ ແລະ ແປງກັບຄືນ.

## ຟັງຊັນ DateSerial

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

## ຟັງຊັນ DateValue

ສົ່ງຄືນວັດຖຸ ວັນທີ ຈາກສະຕຣິງທີ່ແທນວັນທີ.

ວັດຖຸທີ່ສົ່ງຄືນຈະຖືກສະແດງພາຍໃນເປັນຄ່າຕົວເລກດຽວທີ່ກົງກັບວັນທີທີ່ລະບຸ. ຄ່ານີ້ສາມາດໃຊ້ເພື່ອຄຳນວນຈຳນວນວັນລະຫວ່າງສອງວັນທີ.

## ຟັງຊັນ Day

ສົ່ງຄືນຄ່າທີ່ແທນວັນຂອງເດືອນໂດຍອີງຕາມເລກລຳດັບວັນທີທີ່ສ້າງໂດຍ DateSerial ຫຼື DateValue.

## ຟັງຊັນ Month

ສົ່ງຄືນເດືອນຂອງປີຈາກເລກລຳດັບວັນທີທີ່ສ້າງໂດຍຟັງຊັນ DateSerial ຫຼື DateValue.

## ຟັງຊັນ WeekDay

ຟັງຊັນນີ້ສົ່ງຄືນຕົວເລກທີ່ກົງກັບວັນໃນອາທິດ ເຊິ່ງສະແດງໂດຍເລກລຳດັບວັນທີທີ່ສ້າງໂດຍຟັງຊັນ DateSerial ຫຼື DateValue.

## ຟັງຊັນ Year

ສົ່ງຄືນປີຈາກເລກລຳດັບວັນທີທີ່ສ້າງໂດຍຟັງຊັນ DateSerial ຫຼື DateValue.

## ຟັງຊັນ CDate

ແປງຂໍ້ຄວາມ ຫຼື ນິພົດຕົວເລກໃດໆໃຫ້ເປັນຄ່າວັນທີ.

## ຟັງຊັນ CDateToIso

ສົ່ງຄືນວັນທີໃນຮູບແບບ ISO ໂດຍບໍ່ມີຕົວຂັ້ນ (YYYYMMDD) ຈາກເລກລຳດັບວັນທີທີ່ສ້າງໂດຍຟັງຊັນ DateSerial ຫຼື DateValue ຫຼື CDateFromIso.

ສ່ວນຂອງປີຈະປະກອບດ້ວຍຕົວເລກຢ່າງໜ້ອຍສີ່ຫຼັກ, ໂດຍມີເລກສູນນຳໜ້າຖ້າຄ່າສຳບູນໜ້ອຍກວ່າ 1000, ສາມາດເປັນຄ່າລົບໂດຍມີເຄື່ອງໝາຍລົບນຳໜ້າຖ້າວັນທີທີ່ສົ່ງມານັ້ນແມ່ນປີກ່ອນຄຣິສຕະລາດ (BCE) ແລະ ສາມາດມີຫຼາຍກວ່າສີ່ຫຼັກຖ້າຄ່າສຳບູນຫຼາຍກວ່າ 9999. ສະຕຣິງທີ່ສົ່ງຄືນສາມາດຢູ່ໃນຊ່ວງ "-327680101" ຫາ "327671231".

ປີທີ່ໜ້ອຍກວ່າ 100 ແລະ ຫຼາຍກວ່າ 9999 ໄດ້ຮັບການຮອງຮັບຕັ້ງແຕ່ LibreOffice 5.4 ເປັນຕົ້ນມາ.

## ຟັງຊັນ CDateFromIso

ສົ່ງຄືນເລກວັນທີພາຍໃນລະບົບຈາກສະຕຣິງທີ່ບັນຈຸວັນທີໃນຮູບແບບ ISO (YYYYMMDD ຫຼື YYYY-MM-DD).

ສ່ວນຂອງປີຕ້ອງປະກອບດ້ວຍຕົວເລກສອງຫຼັກ (ຮອງຮັບສະເພາະຮູບແບບ YYMMDD ທີ່ບໍ່ມີຕົວຂັ້ນເພື່ອຄວາມເຂົ້າກັນໄດ້ເທົ່ານັ້ນ) ຫຼື ຢ່າງໜ້ອຍສີ່ຫຼັກ. ຖ້າເປັນສີ່ຫຼັກ ຕ້ອງມີເລກສູນນຳໜ້າຖ້າຄ່າສຳບູນໜ້ອຍກວ່າ 1000, ສາມາດເປັນຄ່າລົບໂດຍມີເຄື່ອງໝາຍລົບນຳໜ້າຖ້າວັນທີທີ່ສົ່ງມານັ້ນແມ່ນປີກ່ອນຄຣິສຕະລາດ (BCE) ແລະ ສາມາດມີຫຼາຍກວ່າສີ່ຫຼັກຖ້າຄ່າສຳບູນຫຼາຍກວ່າ 9999. ສະຕຣິງທີ່ຈັດຮູບແບບແລ້ວສາມາດຢູ່ໃນຊ່ວງ "-327680101" ຫາ "327671231", ຫຼື "-32768-01-01" ຫາ "32767-12-31".

ວັນທີທີ່ບໍ່ຖືກຕ້ອງຈະເຮັດໃຫ້ເກີດຂໍ້ຜິດພາດ. ບໍ່ຍອມຮັບປີ 0, ວັນສຸດທ້າຍຂອງ BCE ແມ່ນ -0001-12-31 ແລະ ວັນຖັດໄປຂອງ CE ແມ່ນ 0001-01-01. ວັນທີກ່ອນ 1582-10-15 ຈະຖືວ່າຢູ່ໃນປະຕິທິນເກຣໂກຣຽນ (proleptic Gregorian).

ເມື່ອແປງເລກລຳດັບວັນທີເປັນສະຕຣິງທີ່ພິມໄດ້, ຕົວຢ່າງເຊັ່ນສຳລັບຄຳສັ່ງ Print ຫຼື MsgBox, ຈະມີການໃຊ້ປະຕິທິນເລີ່ມຕົ້ນຂອງການຕັ້ງຄ່າທ້ອງຖິ່ນ ແລະ ໃນວັນທີປ່ຽນຜ່ານ 1582-10-15 ນັ້ນ ອາດຈະມີການປ່ຽນໄປໃຊ້ປະຕິທິນຈູລຽນ (Julian) ເຊິ່ງອາດເຮັດໃຫ້ວັນທີທີ່ສະແດງອອກມາແຕກຕ່າງຈາກທີ່ຄາດໄວ້. ໃຫ້ໃຊ້ ຟັງຊັນ CDateToIso ເພື່ອແປງເລກວັນທີດັ່ງກ່າວໃຫ້ເປັນສະຕຣິງໃນປະຕິທິນເກຣໂກຣຽນ.

ຮູບແບບ YYYY-MM-DD ທີ່ມີຕົວຂັ້ນໄດ້ຮັບການຮອງຮັບຕັ້ງແຕ່ LibreOffice 5.3.4. ປີທີ່ໜ້ອຍກວ່າ 100 ຫຼື ຫຼາຍກວ່າ 9999 ຈະຖືກຍອມຮັບຕັ້ງແຕ່ LibreOffice 5.4 ຖ້າບໍ່ໄດ້ຢູ່ໃນໂໝດຄວາມເຂົ້າກັນໄດ້ຂອງ VBA.

## ຟັງຊັນ CDateToUnoDate

ສົ່ງຄືນວັນທີໃນຮູບແບບໂຄງສ້າງ (struct) UNO com.sun.star.util.Date.

## ຟັງຊັນ CDateFromUnoDate

ແປງໂຄງສ້າງ UNO com.sun.star.util.Date ໃຫ້ເປັນຄ່າ Date.

## ຟັງຊັນ CDateToUnoDateTime

ສົ່ງຄືນສ່ວນຂອງເວລາຈາກວັນທີໃນຮູບແບບໂຄງສ້າງ UNO com.sun.star.util.DateTime.

## ຟັງຊັນ CDateFromUnoDateTime

ແປງໂຄງສ້າງ UNO com.sun.star.util.DateTime ໃຫ້ເປັນຄ່າ Date.

## ຟັງຊັນ DateAdd

ເພີ່ມຊ່ວງວັນທີ ຫຼື ເວລາ ໃຫ້ກັບວັນທີທີ່ກຳນົດຕາມຈຳນວນຄັ້ງ ແລະ ສົ່ງຄືນຜົນລັດວັນທີທີ່ໄດ້.

## ຟັງຊັນ DateDiff

ສົ່ງຄືນຈຳນວນຂອງຊ່ວງວັນທີ ຫຼື ເວລາ ລະຫວ່າງສອງຄ່າວັນທີທີ່ກຳນົດ.

## ຟັງຊັນ DatePart

ຟັງຊັນ DatePart ສົ່ງຄືນສ່ວນຂອງວັນທີທີ່ລະບຸ.

ກະລຸນາສະໜັບສະໜູນພວກເຮົາ!