date ක්‍රියාකාරීත්වය

date ක්‍රියාකාරීත්වය යම් ආකෘතියකින් දිනය ප්‍රතිදානය කරයි. පළමු පරාමිතිය ලෙස ශ්‍රිතය ආකෘතිය පිළිගන්නා අතර, දෙවන විකල්ප පරාමිතිය ලෙස timestamp ආකෘතියෙන් කාලයේ මොහොත පිළිගනී. දෙවන පරාමිතිය නොසඳහන් කළේ නම් - වත්මන් කාලය ගනු ලැබේ, සඳහන් කළේ නම් - ලබා දුන් කාලය ගනු ලැබේ.

ආකෘතිය නියම කරනු ලබන්නේ පාලක අණ මගිනි (ඉංග්‍රීසි අක්ෂර), මේ සමඟ ඒවා අතර ඕනෑම වෙන්කරන යෙදිය හැක (ඉර, කොලන් සහ යනාදිය).

ශ්‍රිතය පහත අණ පිළිගනී (කැපිතල අකුරු සාමාන්‍ය ඒවාට වඩා වෙනස් වේ, කරුණාකර අවධානයෙන් සිටින්න):

• U – 1970 ජනවාරි 1 සිට ගත වූ තත්පර ගණන (එනම් timestamp).
• z – අවුරුද්ද ආරම්භයේ සිට දින අංකය.
• Y – අවුරුද්ද, 4 ඉලක්කම්.
• y - අවුරුද්ද, ඉලක්කම් දෙක.
• m – මාසයේ අංකය (ඉදිරියෙන් ශුන්‍යය සමඟ).
• n – ඉදිරියෙන් ශුන්‍යය නොමැතිව මාසයේ අංකය.
• d – මාසය තුළ දිනයේ අංකය, සැමවිටම ඉලක්කම් දෙකක් (එනම් පළමුවැන්න ශුන්‍යය විය හැකිය).
• j – ඉදිරියෙන් ශුන්‍යය නොමැතිව මාසය තුළ දිනයේ අංකය.
• w – සතියේ දිනය (0 - ඉරිදා, 1 - සඳුදා, යනාදිය).
• h – 12-පැය ආකෘතියෙන් පැය.
• H – 24-පැය ආකෘතියෙන් පැය.
• i – මිනිත්තු.
• s – තත්පර.
• L – 1, අධික අවුරුද්දක් නම්, 0, අධික අවුරුද්දක් නොවේ නම්.
• W – අවුරුද්ද තුළ සතියේ අනුක්‍රමික අංකය.
• t – නියම කරන ලද මාසයේ දින ගණන.

වාක්‍ය රචනා ක්‍රමය

phpdate(string $format, ?int $timestamp = null): string

date සමඟ වැඩ කිරීමේ උදාහරණ

php<?php
  // සියලුම උදාහරණ 2013.06.01 දින සඳහා 12.23.59 වන විට, සඳුදා පෙන්වා ඇත
  
  echo date('Y'); // '2013' ප්‍රතිදානය කරයි
  echo date('y'); // '13' ප්‍රතිදානය කරයි
  echo date('m'); // '06' ප්‍රතිදානය කරයි - මාසයේ අංකය
  echo date('d'); // '01' ප්‍රතිදානය කරයි - මාසය තුළ දිනයේ අංකය
  echo date('j'); // '1'  ප්‍රතිදානය කරයි - මාසය තුළ දිනයේ අංකය (ඉදිරියෙන් ශුන්‍යය නොමැතිව)
  echo date('w'); // '1'  ප්‍රතිදානය කරයි - සඳුදා
  echo date('H'); // '12' ප්‍රතිදානය කරයි - පැය
  echo date('i'); // '23' ප්‍රතිදානය කරයි - මිනිත්තු
  echo date('s'); // '59' ප්‍රතිදානය කරයි - තත්පර
  
  echo date('d-m-Y'); // '01-06-2013' ප්‍රතිදානය කරයි
  echo date('d.m.Y'); // '01.06.2013' ප්‍රතිදානය කරයි
  echo date('H:i:s d.m.Y'); // '12:23:59 01.06.2013' ප්‍රතිදානය කරයි
?>

date ශ්‍රිතයේ දෙවන පරාමිතිය

date ශ්‍රිතයට දෙවන විකල්ප පරාමිතියක් ඇත, එය timestamp ආකෘතියෙන් කාලයේ මොහොත පිළිගනී. මෙම පරාමිතිය සම්ප්‍රේෂණය කළහොත්, date ශ්‍රිතය වත්මන් කාලය නොව, දෙවන පරාමිතිය මගින් සම්ප්‍රේෂණය කරන ලද එම මොහොත ආකෘතිකරණය කරයි. මෙම timestamp ලබා ගත හැකිය, උදාහරණයක් ලෙස, mktime හරහා (නමුත් අනිවාර්ය නොවේ):

php<?php
  echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // '29-12-2013' ප්‍රතිදානය කරයි
?>

මෙය ප්‍රයෝජනයට ගත හැකිය, නිශ්චිත දිනයක් සඳහා සතියේ දිනයේ අංකය සොයා ගැනීමට - හුදෙක් එය mktime ශ්‍රිතය භාවිතයෙන් දෙවන පරාමිතිය ලෙස සම්ප්‍රේෂණය කරන්න, සහ පළමු පරාමිතිය ලෙස පාලක අක්ෂරය 'w' තබන්න:

php<?php
  // 2013-12-29 දින සතියේ කුමන දිනයක්දැයි සොයා බලමු:
  echo date('w', mktime(0, 0, 0, 12, 29, 13)); // '0' ප්‍රතිදානය කරයි - ඉරිදා
?>

මෙයද බලන්න