社区文档构建进行中，欢迎编辑。社区答疑群（非官方）：717421103
全站通知：
帮助:解析函数/calendarenddate
刷
历
编
< 帮助:解析函数
跳到导航
跳到搜索
calendarenddate是一个解析函数。帮助:解析函数页列出了所有解析函数的说明。
calendarenddate
日历届满日期。出自扩展 Semantic MediaWiki SMW功能强大，应用广泛。<br>如需单页内大量调用，请考虑使用模板、模块批量查询，这能提升综合体验、降低资源消耗。<br>另请参阅灰机、Fandom的相关文档，他们详述了对SMW的顾虑和限制。。
在SMW查询中处理日历格式（calendar format）时使用，用于指定当月日历结束日期。
语法
{{#calendarenddate:}}-> 2025-01-05
注意
- 其末尾需要冒号。
- 日历结束日期不一定是当月最后一天。因为日历格式以周为单位显示。
示例
查询当前月份的活动，以日历格式显示。
{{#ask:
[[Category:Events]]
[[Has date::>{{#calendarstartdate:}}]]
[[Has date::<{{#calendarenddate:}}]]
|?Has date
|format=calendar
|limit=300
}}
| 12月 2024 |
| 星期日 | 星期一 | 星期二 | 星期三 | 星期四 | 星期五 | 星期六 |
|
24
|
25
|
26
|
27
|
28
|
29
|
30
|
|
1
|
2
|
3
|
4
|
5
|
6
|
7
|
|
8
|
9
|
10
|
11
|
12
|
13
|
14
|
|
15
|
16
|
17
|
18
|
19
|
20
|
21
|
|
22
|
23
|
24
|
25
|
26
|
27
|
28
|
|
29
|
30
|
31
|
1
|
2
|
3
|
4
|
底层代码
<?php
/** SemanticResultFormats-3.2.0\SemanticResultFormats.parser.php
* Parser functions for the Semantic Result Formats extension.
*
* Two parser functions are defined, both for use by the Calendar format:
*
* #calendarstartdate returns the start date for the set of dates being
* displayed on the screen, according to the query string.
*
* #calendarenddate returns the *day after* the end date for the set of dates
* being displayed on the screen, according to the query string.
*
* @author David Loomer
*/
class SRFParserFunctions {
static function registerFunctions( &$parser ) {
$parser->setFunctionHook( 'calendarstartdate', [ 'SRFParserFunctions', 'runCalendarStartDate' ] );
$parser->setFunctionHook( 'calendarenddate', [ 'SRFParserFunctions', 'runCalendarEndDate' ] );
return true;
}
static function runCalendarStartDate( &$parser, $calendar_type = 'month', $calendar_start_day = null, $calendar_days = 7, $default_year = null, $default_month = null, $default_day = null ) {
if ( $calendar_type == '' ) $calendar_type = 'month';
list( $lower_date, $upper_date, $query_date ) =
SRFParserFunctions::getBoundaryDates( $calendar_type, $calendar_start_day, $calendar_days, $default_year, $default_month, $default_day );
return date( "Y", $lower_date ) . '-' . date( "m", $lower_date ) . '-' . date( "d", $lower_date );
}
static function runCalendarEndDate( &$parser, $calendar_type = 'month', $calendar_start_day = null, $calendar_days = 7, $default_year = null, $default_month = null, $default_day = null ) {
if ( $calendar_type == '' ) $calendar_type = 'month';
list( $lower_date, $upper_date, $query_date ) =
SRFParserFunctions::getBoundaryDates( $calendar_type, $calendar_start_day, $calendar_days, $default_year, $default_month, $default_day );
return date( "Y", $upper_date ) . '-' . date( "m", $upper_date ) . '-' . date( "d", $upper_date );
}
/**
* Obtain both a lower- and upper- bound date to be used for querying.
*
* @param $calendar_type string Values: 'month' (the default) for monthly
* calendar such as SRF Calendar; others not yet defined.
* @param $calendar_start_day int Optionally force the lower bound date to be a certain
* day of the week (0 for Sunday, 6 for Saturday). If using a $calendar_type
* of 'month' this parameter is ignored, as the start day of week for a monthly
* calendar is currently always set as Sunday. Ohterwise defaults to either the day
* supplied in the query string, or the current day.
* @param $calendar_days int The number of days to display. Ignored if using a
* $calendar_type of 'month'; otherwise defaults to 7.
* @param $default_year int (Optional) Default year if none is specified in
* the query string. If parameter is not supplied, will fall back to current year.
* @param $default_month int (Optional) Default month if none is specified in
* the query string. If parameter is not supplied, will fall back to current month.
* @param $default_day int (Optional) Default day of month if none is specified in
* the query string. If parameter is not supplied, will fall back to current day of month.
* @return array First element contains the lower bound date, second
* element contains the upper bound, third element contains a date indicating
* the year/month/day to be queried.
*
*/
static function getBoundaryDates( $calendar_type = 'month', $calendar_start_day = null, $calendar_days = 7, $default_year = null, $default_month = null, $default_day = null ) {
if ( $calendar_type == 'month' ) $calendar_start_day = 0;
if ( $default_year == null ) $default_year = date( "Y", time() );
if ( $default_month == null ) $default_month = date( "n", time() );
if ( $default_day == null ) $default_day = date( "j", time() );
global $wgRequest;
// Set the lower bound based on query string parameters if provided;
// otherwise fall back to defaults.
if ( $wgRequest->getCheck( 'year' ) && $wgRequest->getCheck( 'month' ) ) {
$query_year = $wgRequest->getVal( 'year' );
if ( is_numeric( $query_year ) && ( intval( $query_year ) == $query_year ) ) {
$lower_year = $query_year;
}
else {
$lower_year = $default_year;
}
$query_month = $wgRequest->getVal( 'month' );
if ( is_numeric( $query_month ) && ( intval( $query_month ) == $query_month ) && $query_month >= 1 && $query_month <= 12 ) {
$lower_month = $query_month;
}
else {
$lower_month = $default_month;
}
$query_day = $wgRequest->getVal( 'day' );
if ( $wgRequest->getCheck( 'day' )
&& is_numeric( $query_day )
&& ( intval( $query_day ) == $query_day )
&& $query_day >= 1
&& $query_day <= 31 ) {
$lower_day = $query_day;
} elseif ( $calendar_type != 'month'
&& (int)$lower_year == (int)$default_year
&& (int)$lower_month == (int)$default_month ) {
$lower_day = $default_day;
}
else {
$lower_day = '1';
}
} else {
$lower_year = $default_year;
$lower_month = $default_month;
if ( $calendar_type == 'month' ) {
$lower_day = 1;
}
else {
$lower_day = $default_day;
}
}
$lower_date = mktime( 0, 0, 0, $lower_month, $lower_day, $lower_year );
// Date to be queried
$return_date = $lower_date;
// Set the upper bound based on calendar type or number of days.
if ( $calendar_type == 'month' ) {
$upper_year = date( "Y", $lower_date );
$upper_month = date( "n", $lower_date ) + 1;
if ( $upper_month == 13 ) {
$upper_month = 1;
$upper_year = $upper_year + 1;
}
// One second before start of next month.
$upper_date = mktime( 0, 0, 0, $upper_month, 1, $upper_year ) - 1;
} else {
// One second before start of first day outside our range.
$upper_date = $lower_date + $calendar_days * 86400 - 1;
}
// If necessary, adjust bounds to comply with required days of week for each.
if ( $calendar_type == 'month' || $calendar_start_day >= 0 ) {
$lower_offset = date( "w", $lower_date ) - $calendar_start_day;
if ( $lower_offset < 0 ) {
$lower_offset += 7;
}
if ( $calendar_type == 'month' ) {
$upper_offset = $calendar_start_day + 6 - date( "w", $upper_date );
if ( $upper_offset > 6 ) {
$upper_offset -= 7;
}
} else {
$upper_offset = 0 - $lower_offset;
}
$lower_date = $lower_date - 86400 * $lower_offset;
$upper_date = $upper_date + 86400 * $upper_offset;
}
// Add a day since users will need to use < operator for upper date.
$upper_date += 86400;
return [ $lower_date, $upper_date, $return_date ];
}
}
实际用例
- 暂未发现有BWiki托管的wiki使用此函数。
沪公网安备 31011002002714 号