DateTime.php — GiveWP – Donation Plugin and Fundraising Platform 3.14.2

give / vendor / vendor-prefixed / fakerphp / faker / src / Faker / Provider / DateTime.php

give / vendor / vendor-prefixed / fakerphp / faker / src / Faker / Provider Last commit date

ar_EG 1 year ago ar_JO 1 year ago ar_SA 1 year ago at_AT 1 year ago bg_BG 1 year ago bn_BD 1 year ago cs_CZ 1 year ago da_DK 1 year ago de_AT 1 year ago de_CH 1 year ago de_DE 1 year ago el_CY 1 year ago el_GR 1 year ago en_AU 1 year ago en_CA 1 year ago en_GB 1 year ago en_HK 1 year ago en_IN 1 year ago en_NG 1 year ago en_NZ 1 year ago en_PH 1 year ago en_SG 1 year ago en_UG 1 year ago en_US 1 year ago en_ZA 1 year ago es_AR 1 year ago es_ES 1 year ago es_PE 1 year ago es_VE 1 year ago et_EE 1 year ago fa_IR 1 year ago fi_FI 1 year ago fr_BE 1 year ago fr_CA 1 year ago fr_CH 1 year ago fr_FR 1 year ago he_IL 1 year ago hr_HR 1 year ago hu_HU 1 year ago hy_AM 1 year ago id_ID 1 year ago is_IS 1 year ago it_CH 1 year ago it_IT 1 year ago ja_JP 1 year ago ka_GE 1 year ago kk_KZ 1 year ago ko_KR 1 year ago lt_LT 1 year ago lv_LV 1 year ago me_ME 1 year ago mn_MN 1 year ago ms_MY 1 year ago nb_NO 1 year ago ne_NP 1 year ago nl_BE 1 year ago nl_NL 1 year ago pl_PL 1 year ago pt_BR 1 year ago pt_PT 1 year ago ro_MD 1 year ago ro_RO 1 year ago ru_RU 1 year ago sk_SK 1 year ago sl_SI 1 year ago sr_Cyrl_RS 1 year ago sr_Latn_RS 1 year ago sr_RS 1 year ago sv_SE 1 year ago th_TH 1 year ago tr_TR 1 year ago uk_UA 1 year ago vi_VN 1 year ago zh_CN 1 year ago zh_TW 1 year ago Address.php 1 year ago Barcode.php 1 year ago Base.php 1 year ago Biased.php 1 year ago Color.php 1 year ago Company.php 1 year ago DateTime.php 1 year ago File.php 1 year ago HtmlLorem.php 1 year ago Image.php 1 year ago Internet.php 1 year ago Lorem.php 1 year ago Medical.php 1 year ago Miscellaneous.php 1 year ago Payment.php 1 year ago Person.php 1 year ago PhoneNumber.php 1 year ago Text.php 1 year ago UserAgent.php 1 year ago Uuid.php 1 year ago

DateTime.php

390 lines

1	<?php
2	/**
3	* @license MIT
4	*
5	* Modified by impress-org on 07-August-2024 using Strauss.
6	* @see https://github.com/BrianHenryIE/strauss
7	*/
8
9	namespace Give\Vendors\Faker\Provider;
10
11	class DateTime extends Base
12	{
13	protected static $century = ['I', 'II', 'III', 'IV', 'V', 'VI', 'VII', 'VIII', 'IX', 'X', 'XI', 'XII', 'XIII', 'XIV', 'XV', 'XVI', 'XVII', 'XVIII', 'XIX', 'XX', 'XXI'];
14
15	protected static $defaultTimezone = null;
16
17	/**
18	* @param \DateTime\|float\|int\|string $max
19	*
20	* @return false\|int
21	*/
22	protected static function getMaxTimestamp($max = 'now')
23	{
24	if (is_numeric($max)) {
25	return (int) $max;
26	}
27
28	if ($max instanceof \DateTime) {
29	return $max->getTimestamp();
30	}
31
32	return strtotime(empty($max) ? 'now' : $max);
33	}
34
35	/**
36	* Get a timestamp between January 1, 1970, and now
37	*
38	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
39	*
40	* @return int
41	*
42	* @example 1061306726
43	*/
44	public static function unixTime($max = 'now')
45	{
46	return self::numberBetween(0, static::getMaxTimestamp($max));
47	}
48
49	/**
50	* Get a datetime object for a date between January 1, 1970 and now
51	*
52	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
53	* @param string $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
54	*
55	* @return \DateTime
56	*
57	* @see http://php.net/manual/en/timezones.php
58	* @see http://php.net/manual/en/function.date-default-timezone-get.php
59	*
60	* @example DateTime('2005-08-16 20:39:21')
61	*/
62	public static function dateTime($max = 'now', $timezone = null)
63	{
64	return static::setTimezone(
65	new \DateTime('@' . static::unixTime($max)),
66	$timezone
67	);
68	}
69
70	/**
71	* Get a datetime object for a date between January 1, 001 and now
72	*
73	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
74	* @param string\|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
75	*
76	* @return \DateTime
77	*
78	* @see http://php.net/manual/en/timezones.php
79	* @see http://php.net/manual/en/function.date-default-timezone-get.php
80	*
81	* @example DateTime('1265-03-22 21:15:52')
82	*/
83	public static function dateTimeAD($max = 'now', $timezone = null)
84	{
85	$min = (PHP_INT_SIZE > 4 ? -62135597361 : -PHP_INT_MAX);
86
87	return static::setTimezone(
88	new \DateTime('@' . self::numberBetween($min, static::getMaxTimestamp($max))),
89	$timezone
90	);
91	}
92
93	/**
94	* get a date string formatted with ISO8601
95	*
96	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
97	*
98	* @return string
99	*
100	* @example '2003-10-21T16:05:52+0000'
101	*/
102	public static function iso8601($max = 'now')
103	{
104	return static::date(\DateTime::ISO8601, $max);
105	}
106
107	/**
108	* Get a date string between January 1, 1970 and now
109	*
110	* @param string $format
111	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
112	*
113	* @return string
114	*
115	* @example '2008-11-27'
116	*/
117	public static function date($format = 'Y-m-d', $max = 'now')
118	{
119	return static::dateTime($max)->format($format);
120	}
121
122	/**
123	* Get a time string (24h format by default)
124	*
125	* @param string $format
126	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
127	*
128	* @return string
129	*
130	* @example '15:02:34'
131	*/
132	public static function time($format = 'H:i:s', $max = 'now')
133	{
134	return static::dateTime($max)->format($format);
135	}
136
137	/**
138	* Get a DateTime object based on a random date between two given dates.
139	* Accepts date strings that can be recognized by strtotime().
140	*
141	* @param \DateTime\|string $startDate Defaults to 30 years ago
142	* @param \DateTime\|string $endDate Defaults to "now"
143	* @param string\|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
144	*
145	* @return \DateTime
146	*
147	* @see http://php.net/manual/en/timezones.php
148	* @see http://php.net/manual/en/function.date-default-timezone-get.php
149	*
150	* @example DateTime('1999-02-02 11:42:52')
151	*/
152	public static function dateTimeBetween($startDate = '-30 years', $endDate = 'now', $timezone = null)
153	{
154	$startTimestamp = $startDate instanceof \DateTime ? $startDate->getTimestamp() : strtotime($startDate);
155	$endTimestamp = static::getMaxTimestamp($endDate);
156
157	if ($startTimestamp > $endTimestamp) {
158	throw new \InvalidArgumentException('Start date must be anterior to end date.');
159	}
160
161	$timestamp = self::numberBetween($startTimestamp, $endTimestamp);
162
163	return static::setTimezone(
164	new \DateTime('@' . $timestamp),
165	$timezone
166	);
167	}
168
169	/**
170	* Get a DateTime object based on a random date between one given date and
171	* an interval
172	* Accepts date string that can be recognized by strtotime().
173	*
174	* @param \DateTime\|string $date Defaults to 30 years ago
175	* @param string $interval Defaults to 5 days after
176	* @param string\|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
177	*
178	* @return \DateTime
179	*
180	* @example dateTimeInInterval('1999-02-02 11:42:52', '+ 5 days')
181	*
182	* @see http://php.net/manual/en/timezones.php
183	* @see http://php.net/manual/en/function.date-default-timezone-get.php
184	*/
185	public static function dateTimeInInterval($date = '-30 years', $interval = '+5 days', $timezone = null)
186	{
187	$intervalObject = \DateInterval::createFromDateString($interval);
188	$datetime = $date instanceof \DateTime ? $date : new \DateTime($date);
189	$otherDatetime = clone $datetime;
190	$otherDatetime->add($intervalObject);
191
192	$begin = min($datetime, $otherDatetime);
193	$end = $datetime === $begin ? $otherDatetime : $datetime;
194
195	return static::dateTimeBetween(
196	$begin,
197	$end,
198	$timezone
199	);
200	}
201
202	/**
203	* Get a date time object somewhere within a century.
204	*
205	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
206	* @param string\|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
207	*
208	* @return \DateTime
209	*/
210	public static function dateTimeThisCentury($max = 'now', $timezone = null)
211	{
212	return static::dateTimeBetween('-100 year', $max, $timezone);
213	}
214
215	/**
216	* Get a date time object somewhere within a decade.
217	*
218	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
219	* @param string\|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
220	*
221	* @return \DateTime
222	*/
223	public static function dateTimeThisDecade($max = 'now', $timezone = null)
224	{
225	return static::dateTimeBetween('-10 year', $max, $timezone);
226	}
227
228	/**
229	* Get a date time object somewhere inside the current year.
230	*
231	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
232	* @param string\|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
233	*
234	* @return \DateTime
235	*/
236	public static function dateTimeThisYear($max = 'now', $timezone = null)
237	{
238	return static::dateTimeBetween('first day of january this year', $max, $timezone);
239	}
240
241	/**
242	* Get a date time object somewhere within a month.
243	*
244	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
245	* @param string\|null $timezone time zone in which the date time should be set, default to DateTime::$defaultTimezone, if set, otherwise the result of `date_default_timezone_get`
246	*
247	* @return \DateTime
248	*/
249	public static function dateTimeThisMonth($max = 'now', $timezone = null)
250	{
251	return static::dateTimeBetween('-1 month', $max, $timezone);
252	}
253
254	/**
255	* Get a string containing either "am" or "pm".
256	*
257	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
258	*
259	* @return string
260	*
261	* @example 'am'
262	*/
263	public static function amPm($max = 'now')
264	{
265	return static::dateTime($max)->format('a');
266	}
267
268	/**
269	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
270	*
271	* @return string
272	*
273	* @example '22'
274	*/
275	public static function dayOfMonth($max = 'now')
276	{
277	return static::dateTime($max)->format('d');
278	}
279
280	/**
281	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
282	*
283	* @return string
284	*
285	* @example 'Tuesday'
286	*/
287	public static function dayOfWeek($max = 'now')
288	{
289	return static::dateTime($max)->format('l');
290	}
291
292	/**
293	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
294	*
295	* @return string
296	*
297	* @example '7'
298	*/
299	public static function month($max = 'now')
300	{
301	return static::dateTime($max)->format('m');
302	}
303
304	/**
305	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
306	*
307	* @return string
308	*
309	* @example 'September'
310	*/
311	public static function monthName($max = 'now')
312	{
313	return static::dateTime($max)->format('F');
314	}
315
316	/**
317	* @param \DateTime\|int\|string $max maximum timestamp used as random end limit, default to "now"
318	*
319	* @return string
320	*
321	* @example '1987'
322	*/
323	public static function year($max = 'now')
324	{
325	return static::dateTime($max)->format('Y');
326	}
327
328	/**
329	* @return string
330	*
331	* @example 'XVII'
332	*/
333	public static function century()
334	{
335	return static::randomElement(static::$century);
336	}
337
338	/**
339	* @return string
340	*
341	* @example 'Europe/Paris'
342	*/
343	public static function timezone()
344	{
345	return static::randomElement(\DateTimeZone::listIdentifiers());
346	}
347
348	/**
349	* Internal method to set the time zone on a DateTime.
350	*
351	* @param string\|null $timezone
352	*
353	* @return \DateTime
354	*/
355	private static function setTimezone(\DateTime $dt, $timezone)
356	{
357	return $dt->setTimezone(new \DateTimeZone(static::resolveTimezone($timezone)));
358	}
359
360	/**
361	* Sets default time zone.
362	*
363	* @param string $timezone
364	*/
365	public static function setDefaultTimezone($timezone = null)
366	{
367	static::$defaultTimezone = $timezone;
368	}
369
370	/**
371	* Gets default time zone.
372	*
373	* @return string\|null
374	*/
375	public static function getDefaultTimezone()
376	{
377	return static::$defaultTimezone;
378	}
379
380	/**
381	* @param string\|null $timezone
382	*
383	* @return string\|null
384	*/
385	private static function resolveTimezone($timezone)
386	{
387	return (null === $timezone) ? ((null === static::$defaultTimezone) ? date_default_timezone_get() : static::$defaultTimezone) : $timezone;
388	}
389	}
390