1717/**
1818 * Date calculation utility WordPress Abilities.
1919 *
20- * @since 0.2.0
20+ * @since x.x.x
2121 */
2222class Date_Calculation {
2323
2424 /**
2525 * The default number of occurrences to calculate.
2626 *
27- * @since 0.2.0
27+ * @since x.x.x
2828 * @var int
2929 */
3030 private const OCCURRENCES_DEFAULT = 1 ;
3131
3232 /**
3333 * The maximum number of occurrences allowed.
3434 *
35- * @since 0.2.0
35+ * @since x.x.x
3636 * @var int
3737 */
3838 private const OCCURRENCES_MAX = 52 ;
3939
4040 /**
4141 * Register any needed hooks.
4242 *
43- * @since 0.2.0
43+ * @since x.x.x
4444 */
4545 public function register (): void {
4646 add_action ( 'wp_abilities_api_init ' , array ( $ this , 'register_abilities ' ) );
@@ -49,7 +49,7 @@ public function register(): void {
4949 /**
5050 * Registers any needed abilities.
5151 *
52- * @since 0.2.0
52+ * @since x.x.x
5353 */
5454 public function register_abilities (): void {
5555 $ this ->register_calculate_dates_ability ();
@@ -58,7 +58,7 @@ public function register_abilities(): void {
5858 /**
5959 * Registers the calculate-dates ability.
6060 *
61- * @since 0.2.0
61+ * @since x.x.x
6262 */
6363 private function register_calculate_dates_ability (): void {
6464 wp_register_ability (
@@ -126,7 +126,7 @@ private function register_calculate_dates_ability(): void {
126126 /**
127127 * Execute the calculate-dates ability.
128128 *
129- * @since 0.2.0
129+ * @since x.x.x
130130 *
131131 * @param array<string, mixed> $input The input arguments.
132132 * @return array<string, mixed>|\WP_Error The calculated dates or error.
@@ -172,7 +172,7 @@ public function execute_calculate_dates( array $input ) {
172172 /**
173173 * Permission callback for date calculation.
174174 *
175- * @since 0.2.0
175+ * @since x.x.x
176176 *
177177 * @param array<string, mixed> $args The input arguments.
178178 * @return bool|\WP_Error True if permitted, WP_Error otherwise.
@@ -192,7 +192,7 @@ public function permission_callback( array $args ) {
192192 /**
193193 * Calculate dates from natural language pattern.
194194 *
195- * @since 0.2.0
195+ * @since x.x.x
196196 *
197197 * @param string $pattern The natural language date pattern.
198198 * @param string $start_date The starting date.
@@ -260,7 +260,7 @@ private function calculate_dates( string $pattern, string $start_date, int $occu
260260 /**
261261 * Check if pattern is relative.
262262 *
263- * @since 0.2.0
263+ * @since x.x.x
264264 *
265265 * @param string $pattern The pattern to check.
266266 * @return bool True if pattern is relative.
@@ -272,7 +272,7 @@ private function is_relative_pattern( string $pattern ): bool {
272272 /**
273273 * Check if pattern is nth weekday.
274274 *
275- * @since 0.2.0
275+ * @since x.x.x
276276 *
277277 * @param string $pattern The pattern to check.
278278 * @return bool True if pattern is nth weekday.
@@ -284,7 +284,7 @@ private function is_nth_weekday_pattern( string $pattern ): bool {
284284 /**
285285 * Check if pattern is recurring.
286286 *
287- * @since 0.2.0
287+ * @since x.x.x
288288 *
289289 * @param string $pattern The pattern to check.
290290 * @return bool True if pattern is recurring.
@@ -296,7 +296,7 @@ private function is_recurring_pattern( string $pattern ): bool {
296296 /**
297297 * Check if pattern is interval.
298298 *
299- * @since 0.2.0
299+ * @since x.x.x
300300 *
301301 * @param string $pattern The pattern to check.
302302 * @return bool True if pattern is interval.
@@ -308,7 +308,7 @@ private function is_interval_pattern( string $pattern ): bool {
308308 /**
309309 * Calculate relative dates.
310310 *
311- * @since 0.2.0
311+ * @since x.x.x
312312 *
313313 * @param string $pattern The pattern.
314314 * @param DateTime $start_date The starting date.
@@ -350,7 +350,7 @@ private function calculate_relative_dates( string $pattern, DateTime $start_date
350350 /**
351351 * Calculate nth weekday dates.
352352 *
353- * @since 0.2.0
353+ * @since x.x.x
354354 *
355355 * @param string $pattern The pattern.
356356 * @param DateTime $start_date The starting date.
@@ -403,7 +403,7 @@ private function calculate_nth_weekday_dates( string $pattern, DateTime $start_d
403403 /**
404404 * Calculate recurring dates.
405405 *
406- * @since 0.2.0
406+ * @since x.x.x
407407 *
408408 * @param string $pattern The pattern.
409409 * @param DateTime $start_date The starting date.
@@ -440,7 +440,7 @@ private function calculate_recurring_dates( string $pattern, DateTime $start_dat
440440 /**
441441 * Calculate interval dates.
442442 *
443- * @since 0.2.0
443+ * @since x.x.x
444444 *
445445 * @param string $pattern The pattern.
446446 * @param DateTime $start_date The starting date.
@@ -471,7 +471,7 @@ private function calculate_interval_dates( string $pattern, DateTime $start_date
471471 /**
472472 * Convert ordinal word to number.
473473 *
474- * @since 0.2.0
474+ * @since x.x.x
475475 *
476476 * @param string $ordinal The ordinal word.
477477 * @return int The numeric value.
0 commit comments