Actions

DateFunctions: Difference between revisions

From LimeSurvey Manual

(Marked this version for translation)
No edit summary
Line 13: Line 13:
** The date given should follow the following format "Y-m-d H:i:s", which is for example the one used by the TOKEN:VALIDFROM variable.  
** The date given should follow the following format "Y-m-d H:i:s", which is for example the one used by the TOKEN:VALIDFROM variable.  
** The language used for localization defaults to current session language. If the current language is not configured in the survey, the survey base language will be used. When using in email templates, please use the token language as parameter as to set the expected language. Example: TOKEN:LANGUAGE
** The language used for localization defaults to current session language. If the current language is not configured in the survey, the survey base language will be used. When using in email templates, please use the token language as parameter as to set the expected language. Example: TOKEN:LANGUAGE
<!--T:5-->
[[File:DateFunctions-LocalizeDate Sample.png]]


<!--T:6-->
<!--T:6-->
Line 22: Line 19:
<!--T:7-->
<!--T:7-->
{{Alert|Before using these functions, the plugin must be activated in [[Plugin_manager#General|Plugin Manager]].}}
{{Alert|Before using these functions, the plugin must be activated in [[Plugin_manager#General|Plugin Manager]].}}
=Usage Example on Welcome Message=
<!--T:5-->
[[File:DateFunctions-LocalizeDate Sample Welcome.png|1000px]]
=Usage Example on Email Template=
<!--T:5-->
[[File:DateFunctions-LocalizeDate Sample.png|1000px]]
</translate>
</translate>
[[Category:Plugins]][[Category:Core Plugins]]
[[Category:Plugins]][[Category:Core Plugins]]

Revision as of 18:57, 23 November 2022

 Hint: This features is available starting in version 5.X.Y


Usage

Functions for the ExpressionScript engine to handle date variables:

  • localize_date(date[, language = null]): Formats a date according to the Survey's date format for the specified language.
    • The date given should follow the following format "Y-m-d H:i:s", which is for example the one used by the TOKEN:VALIDFROM variable.
    • The language used for localization defaults to current session language. If the current language is not configured in the survey, the survey base language will be used. When using in email templates, please use the token language as parameter as to set the expected language. Example: TOKEN:LANGUAGE

This plugin uses the ExpressionManagerStart plugin, and it creates this function. These 2 functions don't use JavaScript, so they are fully executed by the server. In case the function is used while taking a survey, the function will be executed only when the respondent moves ahead in the survey.

  Before using these functions, the plugin must be activated in Plugin Manager.


Usage Example on Welcome Message

Usage Example on Email Template