API:EPrints/Time - Revision history

Tdb01r at 09:56, 22 January 2013

2013-01-22T09:56:13Z

Tdb01r at 15:26, 16 December 2011

2011-12-16T15:26:05Z

← Older revision		Revision as of 15:26, 16 December 2011
Line 1:		Line 1:
	<!-- Pod2Wiki=_preamble_		<!-- Pod2Wiki=_preamble_
	This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.		This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.
	-->{{API}}{{Pod2Wiki}}{{API:Source\|file=EPrints/Time.pm\|package_name=EPrints::Time}}[[Category:API\|TIME]][[Category:API:EPrints/Time\|TIME]]<div><!-- Edit below this comment -->		-->{{API}}{{Pod2Wiki}}{{API:Source\|file=perl_lib/EPrints/Time.pm\|package_name=EPrints::Time}}[[Category:API\|TIME]][[Category:API:EPrints/Time\|TIME]]<div><!-- Edit below this comment -->

Tdb01r at 10:46, 25 August 2011

2011-08-25T10:46:37Z

← Older revision		Revision as of 10:46, 25 August 2011
Line 370:		Line 370:

	$xhtml = EPrints::Time::render_short_date( $repo, $value )		$xhtml = EPrints::Time::render_short_date( $repo, $value )
	Render a shorter form of {{API:~~PodLink\|file=\|package_name=\|section=~~render_date\|~~text=/~~render_date}}.		Render a shorter form of [[API:EPrints/Time#render_date\|render_date]].

	E.g.		E.g.
Line 378:		Line 378:
	1954 # no month/day		1954 # no month/day

			<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
			<span style='display:none'>User Comments</span>
			<!-- Edit below this comment -->


			<!-- Pod2Wiki= -->
			</div>
			<!-- Pod2Wiki=head_copyright -->
			==COPYRIGHT==
	<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<span style='display:none'>User Comments</span>		<span style='display:none'>User Comments</span>

Tdb01r at 13:05, 17 June 2010

2010-06-17T13:05:29Z

Show changes

Tdb01r at 15:12, 25 February 2010

2010-02-25T15:12:33Z

← Older revision		Revision as of 15:12, 25 February 2010
Line 1:		Line 1:
	<!-- Pod2Wiki=_preamble_		<!-- Pod2Wiki=_preamble_
	This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.		This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost.
	-->{{API}}{{Pod2Wiki}}{{API:Source\|file=EPrints/Time.pm\|package_name=EPrints::Time}}[[Category:API\|Time]]<div><!-- Edit below this comment -->		-->{{API}}{{Pod2Wiki}}{{API:Source\|file=EPrints/Time.pm\|package_name=EPrints::Time}}[[Category:API\|TIME]][[Category:API:EPrints/Time\|TIME]]<div><!-- Edit below this comment -->

Tdb01r at 13:20, 25 February 2010

2010-02-25T13:20:59Z

← Older revision		Revision as of 13:20, 25 February 2010
Line 46:		Line 46:
	This package contains functions related to time/date functionality.		This package contains functions related to time/date functionality.

			<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
			<span style='display:none'>User Comments</span>
			<!-- Edit below this comment -->


			<!-- Pod2Wiki= -->
			</div>
			<!-- Pod2Wiki=head_methods -->
			==METHODS==
	<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<span style='display:none'>User Comments</span>		<span style='display:none'>User Comments</span>
Line 54:		Line 63:
	</div>		</div>
	<!-- Pod2Wiki=item_render_date -->		<!-- Pod2Wiki=item_render_date -->
	===~~$xhtml = EPrints::Time::~~render_date~~( $handle, $datevalue )~~===		===render_date===

			$xhtml = EPrints::Time::render_date( $handle, $datevalue )
	Render the given date or date and time as a chunk of XHTML.		Render the given date or date and time as a chunk of XHTML.

Line 70:		Line 80:
	</div>		</div>
	<!-- Pod2Wiki=item_render_short_date -->		<!-- Pod2Wiki=item_render_short_date -->
	===~~$xhtml = EPrints::Time::~~render_short_date~~( $handle, $datevalue )~~===		===render_short_date===

			$xhtml = EPrints::Time::render_short_date( $handle, $datevalue )
	Renders a short version of the given date or date and time as a chunk of XHTML.		Renders a short version of the given date or date and time as a chunk of XHTML.

Line 86:		Line 97:
	</div>		</div>
	<!-- Pod2Wiki=item_datestring_to_timet -->		<!-- Pod2Wiki=item_datestring_to_timet -->
	===~~$xhtml = EPrints::Time::~~datestring_to_timet~~( $handle, $datevalue )~~===		===datestring_to_timet===

			$xhtml = EPrints::Time::datestring_to_timet( $handle, $datevalue )
	Returns an interger number of seconds since 1970-01-01:00:00		Returns an interger number of seconds since 1970-01-01:00:00

Line 100:		Line 112:
	</div>		</div>
	<!-- Pod2Wiki=item_gmt_off -->		<!-- Pod2Wiki=item_gmt_off -->
	===~~$xhtml = EPrints::Time::~~gmt_off()===		===gmt_off===

			$xhtml = EPrints::Time::gmt_off()
	Render the current time offset in seconds. This just diffs gmtime and localtime.		Render the current time offset in seconds. This just diffs gmtime and localtime.

Line 112:		Line 125:
	</div>		</div>
	<!-- Pod2Wiki=item_get_month_label -->		<!-- Pod2Wiki=item_get_month_label -->
	===~~$label = EPrints::Time::~~get_month_label~~( $handle, $monthid )~~===		===get_month_label===

			$label = EPrints::Time::get_month_label( $handle, $monthid )
	Return a UTF-8 string describing the month, in the current lanugage.		Return a UTF-8 string describing the month, in the current lanugage.

Line 128:		Line 142:
	</div>		</div>
	<!-- Pod2Wiki=item_get_month_label_short -->		<!-- Pod2Wiki=item_get_month_label_short -->
	===~~$label = EPrints::Time::~~get_month_label_short~~( $handle, $monthid )~~===		===get_month_label_short===

			$label = EPrints::Time::get_month_label_short( $handle, $monthid )
	Return a UTF-8 string of a short representation in month, in the current lanugage.		Return a UTF-8 string of a short representation in month, in the current lanugage.

Line 144:		Line 159:
	</div>		</div>
	<!-- Pod2Wiki=item_get_date_array -->		<!-- Pod2Wiki=item_get_date_array -->
	===~~($year,$month,$day) = EPrints::Time::~~get_date_array~~( [$time] )~~===		===get_date_array===

			($year,$month,$day) = EPrints::Time::get_date_array( [$time] )
	Static method that returns the given time (in UNIX time, seconds since 1.1.79) in an array.		Static method that returns the given time (in UNIX time, seconds since 1.1.79) in an array.

Line 158:		Line 174:
	</div>		</div>
	<!-- Pod2Wiki=item_get_iso_date -->		<!-- Pod2Wiki=item_get_iso_date -->
	===~~$datestamp = EPrints::Time::~~get_iso_date~~( [$time] )~~===		===get_iso_date===

			$datestamp = EPrints::Time::get_iso_date( [$time] )
	Method that returns the given time (in UNIX time, seconds since 1.1.79) in the format used by EPrints and MySQL (YYYY-MM-DD).		Method that returns the given time (in UNIX time, seconds since 1.1.79) in the format used by EPrints and MySQL (YYYY-MM-DD).

Line 172:		Line 189:
	</div>		</div>
	<!-- Pod2Wiki=item_human_time -->		<!-- Pod2Wiki=item_human_time -->
	===~~$timestamp = EPrints::Time::~~human_time~~( [$time] )~~===		===human_time===

			$timestamp = EPrints::Time::human_time( [$time] )
	Return a string describing the current local date and time in the current locale's format (see Perl's 'localtime).		Return a string describing the current local date and time in the current locale's format (see Perl's 'localtime).

Line 184:		Line 202:
	</div>		</div>
	<!-- Pod2Wiki=item_get_iso_timestamp -->		<!-- Pod2Wiki=item_get_iso_timestamp -->
	===~~$timestamp = EPrints::Time::~~get_iso_timestamp~~( [$time] );~~===		===get_iso_timestamp===

			$timestamp = EPrints::Time::get_iso_timestamp( [$time] );
	Return a UTC timestamp of the form YYYY-MM-DDTHH:MM:SSZ		Return a UTC timestamp of the form YYYY-MM-DDTHH:MM:SSZ

Line 200:		Line 219:
	</div>		</div>
	<!-- Pod2Wiki=item_human_delay -->		<!-- Pod2Wiki=item_human_delay -->
	===~~$timestamp = EPrints::Time::~~human_delay~~( $hours );~~===		===human_delay===

			$timestamp = EPrints::Time::human_delay( $hours );
	Returns a human readable amount of time.		Returns a human readable amount of time.

Tdb01r at 13:20, 25 February 2010

2010-02-25T13:20:37Z

Show changes

Pm705@zepler.net at 16:34, 12 February 2010

2010-02-12T16:34:09Z

← Older revision		Revision as of 16:34, 12 February 2010
Line 43:		Line 43:
	==DESCRIPTION==		==DESCRIPTION==
	This package contains functions related to time/date functionality.		This package contains functions related to time/date functionality.



	<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
Line 171:		Line 169:

	$time in seconds from 1970. If not defined then assume current time.		$time in seconds from 1970. If not defined then assume current time.


	<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>

Cjg at 14:03, 24 August 2009

2009-08-24T14:03:59Z

Cjg at 13:14, 20 August 2009

2009-08-20T13:14:57Z

← Older revision		Revision as of 13:14, 20 August 2009
Line 17:		Line 17:
	<!-- Pod2Wiki=head_synopsis --></div>		<!-- Pod2Wiki=head_synopsis --></div>
	==SYNOPSIS==		==SYNOPSIS==
	EPrints::Time::render_date( $handle, "2001-01-12T00:00:00Z" ) #returns XML containing 12 January 2001 00:00		EPrints::Time::render_date( $handle, "2001-01-12T00:00:00Z" )
			# returns XML containing 12 January 2001 00:00
	EPrints::Time::render_short_date( $handle, "2001-01-12T00:00:00Z" ) #returns XML containing 12 Jan 2001 00:00
			EPrints::Time::render_short_date( $handle, "2001-01-12T00:00:00Z" )
	EPrints::Time::get_iso_timestamp( ); # returns NOW in the form YYYY-MM-DDTHH:MM:SSZ		# returns XML containing 12 Jan 2001 00:00

	EPrints::Time::human_delay( 28 ); # returns "1 day"		EPrints::Time::get_iso_timestamp( );
			# returns NOW in the form YYYY-MM-DDTHH:MM:SSZ
	EPrints::Time::get_month_label( $handle, 11 ) # returns November
			EPrints::Time::human_delay( 28 );
	EPrints::Time::get_month_label_short( $handle, 11 ) # returns Nov		# returns "1 day"

			EPrints::Time::get_month_label( $handle, 11 )
			# returns November

			EPrints::Time::get_month_label_short( $handle, 11 )
			# returns Nov

	<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #eef; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>

← Older revision		Revision as of 14:03, 24 August 2009
Line 10:		Line 10:
	'''EPrints::Time''' - Time and Date-related functions		'''EPrints::Time''' - Time and Date-related functions

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 35:		Line 35:
	# returns Nov		# returns Nov

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 46:		Line 46:


	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 60:		Line 60:
	e.g EPrints::Time::render_date( $handle, "2001-01-12T00:00:00Z" ) #returns XML containing 12 January 2001 00:00		e.g EPrints::Time::render_date( $handle, "2001-01-12T00:00:00Z" ) #returns XML containing 12 January 2001 00:00

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 74:		Line 74:
	e.g EPrints::Time::render_short_date( $handle, "2001-01-12T00:00:00Z" ) #returns XML containing 12 Jan 2001 00:00		e.g EPrints::Time::render_short_date( $handle, "2001-01-12T00:00:00Z" ) #returns XML containing 12 Jan 2001 00:00

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 86:		Line 86:
	$datevalue - in the format YYYY-MM-DDTHH:MM:SSZ		$datevalue - in the format YYYY-MM-DDTHH:MM:SSZ

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 96:		Line 96:
	Render the current time offset in seconds. This just diffs gmtime and localtime.		Render the current time offset in seconds. This just diffs gmtime and localtime.

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 110:		Line 110:
	e.g EPrints::Time::get_month_label( $handle, 11 ) # returns November		e.g EPrints::Time::get_month_label( $handle, 11 ) # returns November

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 124:		Line 124:
	e.g EPrints::Time::get_month_label_short( $handle, 11 ) # returns Nov		e.g EPrints::Time::get_month_label_short( $handle, 11 ) # returns Nov

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 136:		Line 136:
	This is the local date not the UTC date.		This is the local date not the UTC date.

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 148:		Line 148:
	This is the localtime date, not UTC.		This is the localtime date, not UTC.

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 158:		Line 158:
	Return a string describing the current local date and time in the current locale's format (see Perl's 'localtime).		Return a string describing the current local date and time in the current locale's format (see Perl's 'localtime).

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 173:		Line 173:


	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->
Line 189:		Line 189:
	e.g. EPrints::Time::human_delay( 400 ); # returns "2 weeks"		e.g. EPrints::Time::human_delay( 400 ); # returns "2 weeks"

	<div style='background-color: #~~eef~~; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>		<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
	<h4><span style='display:none'>User Comments</span></h4>		<h4><span style='display:none'>User Comments</span></h4>
	<!-- Edit below this comment -->		<!-- Edit below this comment -->