|
||||||||||
|
|
||||||||||
| Home: Documentation: Virtual Search Engine: Advanced Features: Date-Time | ||||||||||
Docs 
| « Advanced Features |
| » Date-Time |
Date / Time on result pages
You can easily show current Date and/or Time on your result pages. Date can be shown in both SHORT and LONG format in any of the following 7 languages: Dutch, English, French, German, Italian, Portuguese and Spanish. Time can also be shown in your in many different formats (in any TIME-ZONE).
Date/Time information can only be shown if you assign your own 'html Template'. If you are still showing search results using our default Template you will need to assign your own Template. If you are already using your own Template, you will need to modify your 'html Template' (see below) and re-install it again.
- 1. Showing Date
on result pages:
- You can set your Date string using the following dynamic Parameters. You can use any other characters, text, spaces between Parameters to make your Date format more meaningful (each Parameter MUST be put as they are shown below):
| Date Parameter | Values (generated during search) |
| ##DT## | Date in SHORT format. If the date is less than 10 it will be shown as a single digit (without any preceeding '0' (zero). |
| ##DTDT## | Date in LONG format. Always shows in two digits format. If the date is less than 10 it will be shown with a preceeding '0' (zero). Example: 9 will be shown as '09'. |
| ##MN## | SHORT format for current month in digits. If the month number is less than 10 it will be shown as a single digit (without any preceeding '0' (zero). |
| ##MNMN## | Month in LONG format. Always shows in two digits format. If the current month number is less than 10 it will be shown with a preceeding '0' (zero). Example: July will be shown as '07'. |
| ##MSHORT## | Current month name in SHORT format. First 3 characters from the full month name is shown. Example: January will be shown as 'Jan'. |
| ##MLONG## | Current month name in LONG format. Full name of the month is shown. Example: January will be shown as 'January'. |
| ##YR## | Current year in SHORT format. Last two digits are shown. Example: Year 2000 will be shown as '00'. |
| ##YRYR## | Shows current year in LONG format (in four digits). Example: year 2000 will be shown as '2000'. |
| ##DAYSHORT## | Name of the day in SHORT format. First 3 characters from the full day-name is shown. Example: Monday will be shown as 'Mon'. |
| ##DAYLONG## | Name of the day in LONG format. Full name of the day is shown. Example: Monday will be shown as 'Monday'. |
Examples of Date
strings:
lets assume current date is 5th July 2000 and the day is Monday. For clarity
all the Date Parameters are shown in blue colors.
##MN##/##DT##/##YRYR##
will show Date like:
7/5/2000
##DT##.##MN##.##YR##
will show Date like:
5.7.00
##MNMN##/##DTDT##/##YRYR##
will show Date like:
07/05/2000
##DAYSHORT##, ##MNMN##/##DTDT##/##YRYR##
will show Date like:
Mon, 07/05/2000
##DAYLONG## (##DTDT##-##MSHORT##-##YRYR##).
will show Date like:
Monday (05-July-2000).
You can put any
HTML around the Date/Time strings to change their appearance.
<p><font face="arial,helvetica" size="2"
color="#990000"><b>
##DAYLONG## (##DTDT##-##MSHORT##-##YRYR##).
</b></font>
the above html block
will show-up like:
Monday
(05-July-2000).
<p><font face="arial,helvetica" size="3"
color=#"ff0000"><b>
##DAYLONG##, </b></font>
<font face="arial,helvetica" size="3" color="#006666">
[##MLONG## ##DT##,
##YRYR##]</font>
the above html block
will show-up like:
Monday
[July 5, 2000]
2. Showing Time on result pages:
- You can set your Time string using the following dynamic Parameters. You can use any other characters, text, spaces between Parameters to make your Time format more meaningful (each Parameter MUST be put as they are shown below):
| Time Parameter | Values (generated during search) |
| ##H## | Hour value in SHORT format with 24 hour clock count. If the current hour is less than 10 it will be shown as a single digit (without any preceeding '0' (zero). |
| ##HH## | Hour in LONG format with 24 hours clock count. Shown in two digits format. If the current hour is less than 10 it will be shown with a preceeding '0' (zero). Example: 9 will be shown as '09' and 19 will be shown as '19'. |
| ##H12## | SHORT format for current minute value with 12 hour clock count. If the minute is less than 10 it will be shown as a single digit (without any preceeding '0' (zero). |
| ##HH12## | LONG format for current minute value with 12 hour clock count. If the minute is less than 10 it will be shown with a preceeding '0'. Example: 9 will be shown as '09' and 19 will be shown as '07'. |
| ##S## | Current value of seconds in SHORT format. If the value of seconds is less than 10 it will be shown with a single digit. (In most cases you would probably want to use the following ##SS## LONG format parameter for showing seconds) |
| ##SS## | Current value of seconds in LONG format. Shown in two digits format. If the value of seconds is less than 10 it will be shown with a preceeding '0'. Example: 8 will be shown as '08'. |
| ##AMPM## | You may want to use this parameter if you are showing Time with 12 hour clock count (using ##H12## or ##HH12## for hour value). This parameter shows either 'AM' or 'PM' depending on the time of the day. |
Examples of Time
strings:
lets assume current Time is 09:37:06 (i.e., 9:37:06 AM). For clarity all
the Time Parameters are shown in blue colors.
##H##:##MM##
will show Time like:
9:37
##HH##:##MM##:##SS##
will show Time like:
09:37:06
##H12## : ##MM## :
##SS##
will show Time like:
9 : 37 : 06
will still show Time
like: 9: 37 : 06 even
if the time is 21:37:06 (9:97:06 PM); 12 hour later than our
assumed Time. You may want to use the ##AMPM## parameter to eliminate
such misunderstandings when using 12 hours clock countings for hour value
(##H12## or ##HH12##).
##H12##:##MM##:##SS##
##AMPM##
will show Time like:
9:37:06 AM
##HH12##:##MM##
[##AMPM##]
will show Time like:
09:37 [AM]
You can put any
HTML around the Date/Time strings to change their appearance.
<p><font face="arial,helvetica" size="2"
color="#990000"><b>
##HH##:##MM##:##SS##
</b></font>
the above html block
will show-up like:
09:37:06
<p><font face="arial,helvetica" size="3"
color=#"ff0000"><b>
##HH12##:##MM##
</b></font>
<font face="arial,helvetica" size="1" color="#006600"><i>
##AMPM##</i></font>
the above html block
will show-up like:
09:37
AM
- The default Time-Zone for Date/Time is GMT standard time. However, you can set a different Time-Zone if necessary. If you are using ##DAYSHORT##, ##DAYLONG##, ##MSHORT## or ##MLONG## parameter/s in your Date/Time strings you can also set a different language to show the day/month names in any of the following languages (default language is English).
3. Setting Time-Zone and Date-Format Language:
Time-Zone: To set a different Time-Zone and/or Language you will need to add a New Form Input tzone in your Search-Box (Search-Form). The value of the tzone input should the the number of hours you want the Local-Time on your VSE should be changed to (from the default GMT time). The tzone Input should probably be added as a HIDDEN Form Input so that your visitors do not see it. See the following examples:
To set a time 5 hours
behind GMT (-5 hours from GMT; PST Time) you should set the tzone
Form Input as follows:
<input type="hidden" name="tzone"
value="-5">
To set the Time-Zone
1 hour ahead of GMT (+1 hour from GMT; European Time) you should set the
tzone Form Input as follows:
<input type="hidden" name="tzone"
value="+1">
or simply
<input type="hidden" name="tzone"
value="1">
(you can ommit the
sign in case of positive values)
Date format Language: The default language for Date format is English. However, you can set a different Language using the above mentioned New Form Input tzone with some further modifications. Available languages are: Dutch, French, German, Italian, Portuguese and Spanish. See the examples below:
- Possible Language
values:
- Dutch -> NL
French -> FR
German -> DE
Italian -> IT
Portuguese -> PT
Spanish -> ES
Standard Syntax for
tzone Form Input value (for Time-Zone and
Language):
[+-]H[:L]
H - Number of hours from GMT time. ( - minus sign is REQUIRED,
+ plus sign is optional)
L - two-characters code for the chosen language, MUST
have a preceeding semicolon ':')
Examples:
To choose a Time-Zone of (+1 hour from GMT; European) and Language as
German you should set the tzone value as
follows:
<input type="hidden" name="tzone"
value="1:DE">
or
<input type="hidden" name="tzone"
value="+1:DE">
To choose a Time-Zone
of (+1 hour from GMT) and Language as Spanish you should set the tzone
value as follows:
<input type="hidden" name="tzone"
value="1:ES">
or
<input type="hidden" name="tzone"
value="+1:ES">
To set Language
without changing the Time-Zone you should set the tzone value as follows:
Lets assume you want
to change the default language to Portuguese BUT do not want to change
the default Time-Zone (GMT). The following values will do the trick:
<input type="hidden" name="tzone"
value="0:PT">
Please note that there MUST be a value for Time-Zone anyway. In this case
we are passing 0 (zero) as the Time-Zone value to keep the default GMT
Time-Zone unchanged. BUT the language to be changed to Portuguese (PT).
Important: When setting the Language you
must make sure that the semicolon (:) between Time-Zone and Language values
is present.
CurryGuide, © 1997, 1998, 1999, 2000, 2001, 2002, 2003.
A Division of Highfield Business Corporation