Difference between revisions of "API:EPrints/MetaField/Date"
| Line 14: | Line 14: | ||
<!-- Pod2Wiki=head_description --> | <!-- Pod2Wiki=head_description --> | ||
==DESCRIPTION== | ==DESCRIPTION== | ||
| − | + | This field is used to store a single date. The notation used is <code>YYYY-MM-DD</code>, where <code>YYYY</code> is the 4-digit year, <code>MM</code> is the 2 digit month (starting at 01) and <code>DD</code> is the 2 digit day of the month (starting at 01). | |
| + | |||
| + | MM and DD may be ommitted, giving the following possible values: | ||
| + | |||
| + | <pre> YYYY-MM-DD | ||
| + | YYYY-MM | ||
| + | YYYY</pre> | ||
| + | |||
| + | <!-- Edit below this comment --> | ||
| + | |||
| + | |||
| + | <!-- Pod2Wiki= --> | ||
| + | <!-- Pod2Wiki=head_database --> | ||
| + | ===Database=== | ||
| + | * [fieldname]_year SQL_SMALLINT | ||
| + | * [fieldname]_month SQL_TINYINT | ||
| + | * [fieldname]_day SQL_TINYINT | ||
| + | <!-- Edit below this comment --> | ||
| + | |||
| + | |||
| + | <!-- Pod2Wiki= --> | ||
| + | <!-- Pod2Wiki=head_searching --> | ||
| + | ===Searching=== | ||
| + | Date fields can be searched as either single values or ranges. Searching for "2006" will also match 2006-12-25. You can search for "2000.." to search dates in or after 2000. Or "2000-12..2003-01" for December 2000 through January 2003. | ||
<!-- Edit below this comment --> | <!-- Edit below this comment --> | ||
| Line 31: | Line 54: | ||
:: Render a single text entry box with a Javascript date picker. | :: Render a single text entry box with a Javascript date picker. | ||
| − | |||
* render_res = "day" | * render_res = "day" | ||
: Reduce the resolution the date is shown as. | : Reduce the resolution the date is shown as. | ||
Revision as of 14:23, 11 April 2012
EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects
Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki
NAME
EPrints::MetaField::Date - dates
DESCRIPTION
This field is used to store a single date. The notation used is YYYY-MM-DD, where YYYY is the 4-digit year, MM is the 2 digit month (starting at 01) and DD is the 2 digit day of the month (starting at 01).
MM and DD may be ommitted, giving the following possible values:
YYYY-MM-DD YYYY-MM YYYY
Database
- [fieldname]_year SQL_SMALLINT
- [fieldname]_month SQL_TINYINT
- [fieldname]_day SQL_TINYINT
Searching
Date fields can be searched as either single values or ranges. Searching for "2006" will also match 2006-12-25. You can search for "2000.." to search dates in or after 2000. Or "2000-12..2003-01" for December 2000 through January 2003.
PROPERTIES
In addition to those properties available in EPrints::MetaField:
- input_style = "short"
- long
- Render labeled text entry boxes for year, month and day.
- short
- Render a single text entry box with a Javascript date picker.
- render_res = "day"
- Reduce the resolution the date is shown as.
- render_style = "long"
- long
- Render the full month name.
- short
- Render an abbreviated month name.
METHODS
COPYRIGHT
Copyright 2000-2011 University of Southampton.
This file is part of EPrints http://www.eprints.org/.
EPrints is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
EPrints is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with EPrints. If not, see http://www.gnu.org/licenses/.
