Feature #272 - The internationalization library: Making the date/time formatting functions more convenient for use.

main/inc/lib/internationalization.lib.php

@@ -393,7 +393,8 @@ function api_detect_language(&$string, $encoding = null) {
  * @param string/int $date_format			The date pattern. See the php-manual about the function strftime().
  * Note: For $date_format the following integer constants may be used for using predefined date/time
  * formats in the Chamilo system: TIME_NO_SEC_FORMAT, DATE_FORMAT_SHORT, DATE_FORMAT_LONG, DATE_TIME_FORMAT_LONG.
- * @param int $time_stamp (optional)	Time as an integer value. The default value -1 means now, the function time() is called internally.
+ * @param int/string $time_stamp (optional)	Time as an integer value. The default value -1 means now, the function time() is called internally.
+ * 											This parameter also could be a string, 'Y-m-d H:i:s' formatted.
  * @param string $language (optional)		Language indentificator. If it is omited, the current interface language is assumed.
  * @return string							Returns the formatted date.
  * @link http://php.net/manual/en/function.strftime.php
@@ -402,6 +403,9 @@ function api_format_date($date_format, $time_stamp = -1, $language = null) {
 	if ($time_stamp == -1) {
 		$time_stamp = time();
 	}
+	if (is_string($time_stamp)) {
+		$time_stamp = strtotime($time_stamp);
+	}
 	if (is_int($date_format)) {
 		switch ($date_format) {
 			case TIME_NO_SEC_FORMAT:
@@ -435,7 +439,8 @@ function api_format_date($date_format, $time_stamp = -1, $language = null) {
  * Returns date and time with long format correspondent to a given language.
  * This function is a workaround, it is designed to work for PHP 5.2.x and PHP 5.3+.
  * @author Ivan Tcholakov, 2010
- * @param int $time_stamp (optional)	Time as an integer value. The default value -1 means now, the function time() is called internally.
+ * @param int/string $time_stamp (optional)	Time as an integer value. The default value -1 means now, the function time() is called internally.
+ * 											This parameter also could be a string, 'Y-m-d H:i:s' formatted.
  * @param string $language (optional)		Language indentificator. If it is omited, the current interface language is assumed.
  * @return string							Returns the formatted date.
  */
@@ -444,6 +449,9 @@ function api_format_date_time_long($time_stamp = -1, $language = null) {
 	if ($time_stamp == -1) {
 		$time_stamp = time();
 	}
+	if (is_string($time_stamp)) {
+		$time_stamp = strtotime($time_stamp);
+	}
 	if (IS_PHP_53 && INTL_INSTALLED && !isset($date_formatter)) {
 		$locale = _api_get_locale_from_language($language);
 		$date_formatter = datefmt_create($locale, IntlDateFormatter::FULL, IntlDateFormatter::SHORT);