Class Date

คลาสจัดการเกี่ยวกับวันที่และเวลา.

Namespace: Kotchasan
Author: Goragod Wiriya admin@goragod.com
Since: 1.0
Located at Kotchasan/Date.php

Methods summary
`public`	# `__construct( )` class constructer. class constructer.
`public static array`	# `compare( string\|integer $begin_date, istring\|integer $end_date )` ฟังก์ชั่น คำนวนความแตกต่างของวัน (เช่น อายุ) คืนค่า จำนวนวัน(ติดลบได้) ปี เดือน วัน [days, year, month, day] ที่แตกต่าง. ฟังก์ชั่น คำนวนความแตกต่างของวัน (เช่น อายุ) คืนค่า จำนวนวัน(ติดลบได้) ปี เดือน วัน [days, year, month, day] ที่แตกต่าง. Parameters `$begin_date` วันที่เริ่มต้นหรือวันเกิด (Unix timestamp หรือ วันที่ รูปแบบ YYYY-m-d) `$end_date` วันที่สิ้นสุดหรือวันนี้ (Unix timestamp หรือ วันที่ รูปแบบ YYYY-m-d) Returns array Assert (mktime(0, 0, 0, 2, 1, 2016), mktime(0, 0, 0, 3, 1, 2016)) [==] array('days' => 29, 'year' => 0,'month' => 1, 'day' => 0) ('2016-3-1', '2016-2-1') [==] array('days' => -29, 'year' => 0,'month' => 1, 'day' => 0)
`public static integer`	# `timeDiff( $firstTime, $lastTime )` คืนค่าเวลาที่แตกต่าง หน่วย msec. คืนค่าเวลาที่แตกต่าง หน่วย msec. Parameters `$firstTime` `$lastTime` Returns integer Assert ('08:00', '09:00') [==] 3600
`public static string`	# `dateName( integer $date, boolean $short_date = true )` แปลงตัวเลขเป็นชื่อวันตามภาษาที่ใช้งานอยู่ คืนค่า อาทิตย์...6 เสาร์. แปลงตัวเลขเป็นชื่อวันตามภาษาที่ใช้งานอยู่ คืนค่า อาทิตย์...6 เสาร์. Parameters `$date` 0-6 `$short_date` true (default) วันที่แบบสั้น เช่น อ., false ชื่อเดือนแบบเต็ม เช่น อาทิตย์ Returns string Assert (0) [==] 'อา.' (0, false) [==] 'อาทิตย์'
`public static integer`	# `day( integer $mktime = 0 )` อ่านวันที่. อ่านวันที่. Parameters `$mktime` เวลารูปแบบ Unix timestamp, ไม่ระบุ เป็นวันนี้ Returns integer Assert (mktime(0, 0, 0, 2, 29, 2016)) [==] 29
`public static string`	# `format( integer\|string $time = 0, string $format = '' )` ฟังก์ชั่นแปลงเวลาเป็นวันที่ตามรูปแบบที่กำหนด สามารถคืนค่าวันเดือนปี พศ. ได้ ขึ้นกับไฟล์ภาษา คืนค่า วันที่และเวลาตามรูปแบบที่กำหนดโดย $format. ฟังก์ชั่นแปลงเวลาเป็นวันที่ตามรูปแบบที่กำหนด สามารถคืนค่าวันเดือนปี พศ. ได้ ขึ้นกับไฟล์ภาษา คืนค่า วันที่และเวลาตามรูปแบบที่กำหนดโดย $format. Parameters `$time` int เวลารูปแบบ Unix timestamp, string เวลารูปแบบ Y-m-d หรือ Y-m-d H:i:s ถ้าไม่ระบุหรือระบุ หมายถึงวันนี้ `$format` รูปแบบของวันที่ที่ต้องการ (ถ้าไม่ระบุจะใช้รูปแบบที่มาจากระบบภาษา DATE_FORMAT) Returns string Assert (0) [!=] '' (null) [==] '' (1454259600, 'Y-m-d H:i:s') [==] '2559-02-01 00:00:00'
`public static integer`	# `i18nYear( integer $year )` แปลงเป็นปีที่อ่านได้จากฐานข้อมูลหรือ PHP เป็นปีตามภาษาที่ใช้งานอยู่ เช่น ภาษาไทยใช้ พศ. ($year + 543) ภาษาอังกฤษ ใช้ คศ. ($year). แปลงเป็นปีที่อ่านได้จากฐานข้อมูลหรือ PHP เป็นปีตามภาษาที่ใช้งานอยู่ เช่น ภาษาไทยใช้ พศ. ($year + 543) ภาษาอังกฤษ ใช้ คศ. ($year). Parameters `$year` Returns integer
`public static string`	# `mktimeToSqlDate( integer $mktime = 0 )` แปลงวันที่ จาก mktime เป็น Y-m-d สามารถบันทึกลงฐานข้อมูลได้ทันที คืนค่าวันที่รูป Y-m-d. แปลงวันที่ จาก mktime เป็น Y-m-d สามารถบันทึกลงฐานข้อมูลได้ทันที คืนค่าวันที่รูป Y-m-d. Parameters `$mktime` เวลารูปแบบ Unix timestamp, ไม่ระบุ เป็นวันนี้ Returns string Assert (1453522271) [==] date('Y-m-d', 1453522271)
`public static string`	# `mktimeToSqlDateTime( integer $mktime = 0 )` แปลงวันที่ จาก mktime เป็น Y-m-d H:i:s สามารถบันทึกลงฐานข้อมูลได้ทันที คืนค่า วันที่และเวลาของ mysql เช่น Y-m-d H:i:s. แปลงวันที่ จาก mktime เป็น Y-m-d H:i:s สามารถบันทึกลงฐานข้อมูลได้ทันที คืนค่า วันที่และเวลาของ mysql เช่น Y-m-d H:i:s. Parameters `$mktime` เวลารูปแบบ Unix timestamp, ไม่ระบุ เป็นวันนี้ Returns string Assert (1454259600) [==] '2016-02-01 00:00:00'
`public static integer`	# `month( integer $mktime = 0 )` อ่านเดือน. อ่านเดือน. Parameters `$mktime` เวลารูปแบบ Unix timestamp, ไม่ระบุ เป็นเดือนนี้ Returns integer Assert (mktime(0, 0, 0, 2, 29, 2016)) [==] 2
`public static string`	# `monthName( integer $month, boolean $short_month = true )` แปลงตัวเลขเป็นชื่อเดือนตามภาษาที่ใช้งานอยู่ คืนค่า 1 มกราคม...12 ธันวาคม แปลงตัวเลขเป็นชื่อเดือนตามภาษาที่ใช้งานอยู่ คืนค่า 1 มกราคม...12 ธันวาคม Parameters `$month` 1-12 `$short_month` true (default) ชื่อเดือนแบบสั้น เช่น มค., false ชื่อเดือนแบบเต็ม เช่น มกราคม Returns string Assert (1) [==] 'ม.ค.' (1, false) [==] 'มกราคม'
`public static array\|boolean`	# `parse( string $date )` แยกวันที่ออกเป็น array คืนค่า array(y, m, d, h, i, s) หรือ array(y, m, d) หากเป้นวันที่อย่างเดียว หรือ false หากไม่ใช่วันที่. แยกวันที่ออกเป็น array คืนค่า array(y, m, d, h, i, s) หรือ array(y, m, d) หากเป้นวันที่อย่างเดียว หรือ false หากไม่ใช่วันที่. Parameters `$date` Returns array\|boolean
`public static integer`	# `sqlDateTimeToMktime( string $date )` ฟังก์ชั่น แปลงวันที่และเวลาของ sql เป็น mktime คืนค่าเวลาในรูป mktime. ฟังก์ชั่น แปลงวันที่และเวลาของ sql เป็น mktime คืนค่าเวลาในรูป mktime. Parameters `$date` วันที่ในรูปแบบ Y-m-d H:i:s Returns integer Assert ('2016-02-01 00:00:00') [==] 1454259600
`public static integer`	# `year( integer $mktime = 0 )` อ่านปี คศ. อ่านปี คศ. Parameters `$mktime` เวลารูปแบบ Unix timestamp, ไม่ระบุ เป็นปีนี้ Returns integer Assert (mktime(0, 0, 0, 2, 29, 2016)) [==] 2016