Η Κλάση DateInterval

Η κλάση DateInterval επιτρέπει την εργασία με χρονικά διαστήματα στην PHP. Χρησιμοποιείται για την αποθήκευση της διαφοράς μεταξύ δύο ημερομηνιών ή για τον ορισμό ενός διαστήματος σε μεθόδους εργασίας με ημερομηνίες. Το διάστημα δημιουργείται σε μια ειδική μορφή.

Σύνταξη

phpDateInterval::__construct(string $duration)

Μορφή διαστήματος

Η μορφή αποτελείται από το γράμμα P (period) και τα στοιχεία:

phpP{y}Y{m}M{d}DT{h}H{m}M{s}S{w}W

Σε αυτή τη μορφή: Y - χρόνια, M - μήνες, D - ημέρες, T - διαχωριστικός χρόνου, H - ώρες, M - λεπτά, S - δευτερόλεπτα, W - εβδομάδες.

Πριν από αυτά τα γράμματα πρέπει να γράφεται η αντίστοιχη τιμή. Για παράδειγμα, το 3Y θα σημαίνει τρία χρόνια, ενώ το 5Y2M θα σημαίνει 5 χρόνια και 2 μήνες.

Μετά τη δημιουργία, το αντικείμενο DateInterval θα περιέχει τις ακόλουθες ιδιότητες:

php<?php
  $interval->y  // χρόνια
  $interval->m  // μήνες
  $interval->d  // ημέρες
  $interval->h  // ώρες
  $interval->i  // λεπτά
  $interval->s  // δευτερόλεπτα
  $interval->f  // μικροδευτερόλεπτα
  $interval->invert // 1 εάν το διάστημα είναι αρνητικό
  $interval->days // αριθμός ημερών (εάν δημιουργήθηκε μέσω diff())
?>

Ας δούμε τη λειτουργία του διαστήματος σε παραδείγματα:

Παράδειγμα

Ας δημιουργήσουμε ένα διάστημα 1 ώρας, 45 λεπτών και 30 δευτερολέπτων:

php<?php
  $interval = new DateInterval('PT1H45M30S');
  var_dump($interval);
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

phpDateInterval Object
(
  'y' => 0
  'm' => 0
  'd' => 0
  'h' => 1
  'i' => 45
  's' => 30
)

Παράδειγμα

Ας δημιουργήσουμε ένα διάστημα 3 εβδομάδων και 2 ημερών:

php<?php
  $interval = new DateInterval('P3W2D');
  var_dump($interval);
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

phpDateInterval Object
(
  'y' => 0
  'm' => 0
  'd' => 23
  'h' => 0
  'i' => 0
  's' => 0
)

Παράδειγμα

Ας δημιουργήσουμε ένα διάστημα 5 μηνών, 10 ημερών και 6 ωρών:

php<?php
  $interval = new DateInterval('P5M10DT6H');
  var_dump($interval);
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

phpDateInterval Object
(
  'y' => 0
  'm' => 5
  'd' => 10
  'h' => 6
  'i' => 0
  's' => 0
)

Παράδειγμα

Ας δημιουργήσουμε ένα διάστημα 2 ετών και 15 λεπτών:

php<?php
  $interval = new DateInterval('P2YT15M');
  var_dump($interval);
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

phpDateInterval Object
(
  'y' => 2
  'm' => 0
  'd' => 0
  'h' => 0
  'i' => 15
  's' => 0
)

Παράδειγμα

Ας δημιουργήσουμε ένα διάστημα 1 ημέρας, 12 ωρών και 30 δευτερολέπτων:

php<?php
  $interval = new DateInterval('P1DT12H30S');
  var_dump($interval);
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

phpDateInterval Object
(
  'y' => 0
  'm' => 0
  'd' => 1
  'h' => 12
  'i' => 0
  's' => 30
)

Παράδειγμα

Ας δημιουργήσουμε ένα αρνητικό διάστημα 1 έτους και 3 μηνών (διάστημα προς τα πίσω):

php<?php
  $interval = new DateInterval('P1Y3M');
  $interval->invert = 1;
  var_dump($interval);
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

phpDateInterval Object
(
  'y' => 1
  'm' => 3
  'd' => 0
  'h' => 0
  'i' => 0
  's' => 0
  'invert' => 1
)

Παράδειγμα

Ας δημιουργήσουμε ένα αρνητικό διάστημα 2 ωρών, 30 λεπτών (διάστημα προς τα πίσω):

php<?php
  $interval = new DateInterval('PT2H30M');
  $interval->invert = 1;
  var_dump($interval);
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

phpDateInterval Object
(
  'y' => 0
  'm' => 0
  'd' => 0
  'h' => 2
  'i' => 30
  's' => 0
  'invert' => 1
)

Παράδειγμα

Ας προσθέσουμε ένα διάστημα στην τρέχουσα ημερομηνία:

php<?php
  $date = new DateTime('2023-01-01');
  $interval = new DateInterval('P10D');
  $date->add($interval);
  echo $date->format('Y-m-d');
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

php'2023-01-11'

Παράδειγμα

Ας υπολογίσουμε τη διαφορά μεταξύ δύο ημερομηνιών:

php<?php
  $date1 = new DateTime('2023-01-01');
  $date2 = new DateTime('2023-02-15');
  $interval = $date1->diff($date2);
  echo $interval->format('%m μήνες %d ημέρες');
?>

Αποτέλεσμα εκτέλεσης του κώδικα:

php'1 μήνες 14 ημέρες'

Δείτε επίσης