Personalizza la data e l'ora del timbro

Personalizza le marche temporali utilizzando Livefyre.js.

Le app Livefyre forniscono il parametro di opzione datetimeFormat, per specificare il formato di data come descritto di seguito.

• Terminologia
• Formattazione
• Designazione del simbolo

Terminologia

• Le marche temporali assolute sono definite come ore esatte e specifiche (ad esempio 1 gennaio 2012 12:00)
• Le marche temporali relative sono definite come date generali e meno precise (ad esempio 25 secondi fa, 14 minuti fa, 1 giorno fa, 1 anno fa, ecc.)

Formattazione

Il parametro datetimeFormat ha il seguente comportamento predefinito quando non viene fornito alcun argomento:

• Formato data/ora di: MMMM gg aaaa (per l’8 gennaio 2012)
• 20160 Minuti (14 giorni) fino al tempo assoluto (14 giorni fino a quando le marche temporali relative diventano marche temporali assolute)

Il parametro datetimeFormat accetta tre possibili tipi di argomento: datetime, format e string.

// Example 1 (Datetime format string)  
var convConfig = { 
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo", 
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc", 
   "siteId":"12345", 
   "articleId":5, 
   "el":"comments1", 
   "datetimeFormat": 'MMM d y Ka' 
}; 
var conv = fyre.conv.load(networkConfig, [convConfig]);

Un oggetto che specifica AbsoluteFormat e/o minutesWaitAbsoluteTime. Un minutesFinoAbsoluteTime con un valore pari a -1 renderà immediatamente il tempo assoluto.

// Example 2 (Object)  
var convConfig = { 
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo", 
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc", 
   "siteId":"12345", 
   "articleId":5, 
   "el":"comments1", 
   "datetimeFormat": { 
      minutesUntilAbsoluteTime: 10, 
      absoluteFormat: 'MMM d y Ka' 
   } 
};  
var conv = fyre.conv.load(networkConfig, [convConfig]);

Funzione che utilizza come argomento un oggetto Date e restituisce una stringa datetime da visualizzare

// Example 3 (Function accepting a Date object, returning a datetime string to display) 
var convConfig = { 
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo", 
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc", 
   "siteId":"12345", 
   "articleId":5, 
   "el":"comments1", 
   "datetimeFormat": function(theDateInput) { 
      return +theDateInput; 
   } 
};  
var conv = fyre.conv.load(networkConfig, [convConfig]);

Designazione simbolo

Funzioni di formattazione di data/ora conformi alle specifiche del pattern definite in JDK, ICU e CLDR, con modifiche minori per l’utilizzo tipico in JS. Per ulteriori informazioni, consulta la Documentazione della libreria di chiusura di Google.

  Symbol Meaning Presentation        Example 
  ------   -------                 ------------        ------- 
  G        era designator          (Text)              AD 
  y#       year                    (Number)            1996 
  Y* year (week of year)     (Number)            1997 
  u* extended year           (Number)            4601 
  M        month in year           (Text & Number)     July & 07 
  d        day in month            (Number)            10 
  h        hour in am/pm (1~12)    (Number)            12 
  H        hour in day (0~23)      (Number)            0 
  m        minute in hour          (Number)            30 
  s        second in minute        (Number)            55 
  S        fractional second       (Number)            978 
  E        day of week             (Text)              Tuesday 
  e* day of week (local 1~7) (Number)            2 
  D* day in year             (Number)            189 
  F* day of week in month    (Number)            2 (2nd Wed in July) 
  w* week in year            (Number)            27 
  W* week in month           (Number)            2 
  a        am/pm marker            (Text)              PM 
  k        hour in day (1~24)      (Number)            24 
  K        hour in am/pm (0~11)    (Number)            0 
  z        time zone               (Text)              Pacific Standard Time 
  Z        time zone (RFC 822)     (Number)            -0800 
  v        time zone (generic)     (Text)              Pacific Time 
  g* Julian day              (Number)            2451334 
  A* milliseconds in day     (Number)            69540000 
  '        escape for text         (Delimiter)         'Date=' 
  ''       single quote            (Literal)           'o''clock'

Gli elementi contrassegnati con "*" non sono ancora supportati.

Gli elementi contrassegnati con "#" funzionano in modo diverso rispetto a Java.

Il formato viene determinato dal numero di lettere del pattern.

• Testo: 4 o superiore, utilizza il modulo completo. Meno di 4, utilizzare il formato breve o abbreviato se esiste. (Ad esempio: "EEEE" produce "lunedì", "EEE" produce "lun").
• Numero: il numero minimo di cifre. I numeri più brevi vengono aggiunti automaticamente a questa quantità (ad esempio: Se "m" produce "6", "mm" produce "06".). l'anno è trattato in modo speciale; cioè, se il numero di "y" è 2, l’anno verrà troncato a 2 cifre. (Ad esempio: se "yyyy" produce "1997", "yy" produce "97".) A differenza di altri campi, i secondi frazionari vengono aggiunti a destra con zero.
• Testo e numero: 3 o superiore, utilizza il testo. Meno di 3, utilizzare il numero. (Ad esempio: "M" produce "1", "MM" produce "01", "MMM" produce "Jan" e "MMMM" produce "gennaio".)

Qualsiasi carattere del pattern che non rientri negli intervalli di ["a"…"z’] e ["A"…"Z’] sarà trattato come testo tra virgolette. Ad esempio, i caratteri come ":", ".", ", "#" e "@" appariranno nel testo temporale risultante anche se non sono racchiusi tra virgolette singole.