void Format::setNumFormat (
string $num_format
)
Définit le format numérique. Il peut être une date, une heure, etc. La table suivante liste les valeurs possibles pour le paramètre $num_format et les types correspondants qu'un format numérique attend en tant qu'arguments.
| 0 | Décimal | Le nombre de zéros spécifie le nombre de digits à afficher |
| 0.00 | Décimal | Le nombre de zéros après le point des décimals spécifie le nombre de décimals à afficher |
| #.## | Décimal | Le nombre de dièses après le point des décimals spécifie le nombre maximal de décimals à afficher |
| 0% | Pourcentage | Le nombre de zéros spécifie le nombre de digits à afficher |
| 0.000% | Pourcentage | Le nombre de zéros après le point des décimals spécifie le nombre de décimals à afficher |
| $#.#;[Red]($#.#) | monaitaire | Les zéros et les signes dièses ont la même signification que pour les autres formats |
| ??/?? | Fraction | Le nombre de points d'interrogations dans le dénominateur déterminent la précision (nombre maximal de digits dans le dénominateur) |
| # ??/?? | Fraction | Une fraction avec une partie entière. Les zéros et les signes dièses sont utilisés pour définir la partie entière, et ils ont la même signification que pour les autres formats |
| 0.00E+# | Scientifique | La base de notation scientifique et exponentielle sont formattés en appliquant les mêmes règles que pour les décimals. Pour la notation scientifique, les zéros et les signes dièses ont une signification équivalente |
| D-MMM-YY | Date | Une date représentée dans la notation donnée. Les mois peuvent être sur un ou deux digits, ou sur trois lettres représentant le mois. Les années peuvent avoir 2 ou 4 digits. L'argument formatté en tant que date est considéré représenter le nombre de jours depuis le 30 Décembre 1899 (jour zéro pour Excel). Pour les dates antérieures au jour zéro d'Excel, les nombres négatifs peuvent être utilisés |
| D/M/YYYY h:mm:ss | Date/Heure | Une date représentant la notation donnée. L'argument formatté en tant que date est considéré représenter le nombre de jours depuis le 30 Décembre 1899 (jour zéro pour Excel) |
| h:mm:ss AM/PM | Heure | Une heure représentant la notation donnée. Soyez prudent, l'argument formatté en tant qu'heure doit être donné en nombre de jours. Par exemple, un argument de 0.5 sera représenté comme '12:00:00 PM' |
Les informations ci-dessus proviennent de la documentation d'OpenOffice sur le format de fichier Excel (http://sc.openoffice.org/excelfileformat.pdf).
string $num_format - Le format numérique
This function can not be called statically.
Exemple avec setNumFormat()
<?php
require_once 'Spreadsheet/Excel/Writer.php';
$workbook = new Spreadsheet_Excel_Writer();
$worksheet =& $workbook->addWorksheet();
// nous affichons des dates avec le mois sur trois lettres et l'année sur 4 digits
$date_format =& $workbook->addFormat();
$date_format->setNumFormat('D-MMM-YYYY');
// nombre de secondes dans une journée
$seconds_in_a_day = 86400;
// Timestamps Unix en différence de date Excel, en secondes
$ut_to_ed_diff = $seconds_in_a_day * 25569;
// Affiche le jour zéro pour Excel
$worksheet->write(0, 0, "Jour zéro d'Excel");
$worksheet->write(0, 1, 0, $date_format);
// affiche la date du jour
$now = time();
$worksheet->write(1, 0, "Date du jour :");
$worksheet->write(1, 1, ($now + $ut_to_ed_diff) / $seconds_in_a_day, $date_format);
$workbook->send('num_formatting.xls');
$workbook->close();
?>