1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
---
title: File.lastModified
slug: Web/API/File/lastModified
tags:
- API
- Ficheiros
- File API
- Propriedade
- Referencia
translation_of: Web/API/File/lastModified
---
<div>{{APIRef("File")}}</div>
<p>A propriedade <em>read-only</em> <code><strong>File.lastModified</strong></code> indica a ultima data em que o ficheiro foi modificado, na forma do numero de milissegundos desde o início da era Unix (1 de janeiro de 1970 às 00:00:00). Os ficheiros cuja a data da última modificação não é conhecida devolvem a data actual.</p>
<h2 id="Sintaxe">Sintaxe</h2>
<pre class="syntaxbox notranslate">const <em>tempo</em> = <em>instanciaDeFicheiro</em>.lastModified;
</pre>
<h3 id="Valor">Valor</h3>
<p>Um número que representa o número de milissegundos desde o início da época do Unix.</p>
<h2 id="Exemplo">Exemplo</h2>
<h3 id="Leitura_a_partir_da_entrada_do_ficheiro">Leitura a partir da entrada do ficheiro</h3>
<pre class="brush: html notranslate"><input type="file" multiple id="entradaDeFicheiro">
</pre>
<pre class="brush:js notranslate">const entradaDeFicheiro = document.querySelector('#entradaDeFicheiro');
entradaDeFicheiro.addEventListener('change', (event) => {
// ficheiros é um objeto de FileList (semelhante a NodeList)
const ficheiros = event.target.files;
for (let ficheiro of ficheiros) {
const data = new Date(ficheiro.lastModified);
console.log(`${ficheiro.name} tem uma última data modificada de ${data}`);
}
});
</pre>
<p>Veja os resultados abaixo:</p>
<p>{{ EmbedLiveSample('Leitura_a_partir_da_entrada_do_ficheiro', 300, 50) }}</p>
<h3 id="Ficheiros_criados_dinamicamente">Ficheiros criados dinamicamente</h3>
<p>Se um objeto File for criado dinamicamente, a última data modificada pode ser fornecida na função construtor {{domxref("File.File()", "new File()")}}. Se estiver em falta, lastModified herda a hora actual de {{jsxref("Date.now()")}} no momento em que o objeto File é criado.</p>
<pre class="brush:js notranslate">const ficheiroComData = new File([], 'file.bin', {
lastModified: new Date(2017, 1, 1),
});
console.log(ficheiroComData.lastModified); //devolve 1485903600000
const ficheiroSemData = new File([], 'file.bin');
console.log(ficheiroSemData.lastModified); //devolve data atual em milissegundos
</pre>
<h2 id="Reduced_time_precision">Reduced time precision</h2>
<p>To offer protection against timing attacks and fingerprinting, the precision of <code>someFile.lastModified</code> might get rounded depending on browser settings.<br>
In Firefox, the <code>privacy.reduceTimerPrecision</code> preference is enabled by default and defaults to 20us in Firefox 59; in 60 it will be 2ms.</p>
<pre class="brush: js notranslate">// reduced time precision (2ms) in Firefox 60
someFile.lastModified;
// 1519211809934
// 1519211810362
// 1519211811670
// ...
// reduced time precision with `privacy.resistFingerprinting` enabled
someFile.lastModified;
// 1519129853500
// 1519129858900
// 1519129864400
// ...
</pre>
<p>In Firefox, you can also enabled <code>privacy.resistFingerprinting</code>, the precision will be 100ms or the value of <code>privacy.resistFingerprinting.reduceTimerPrecision.microseconds</code>, whichever is larger.</p>
<h2 id="Especificações">Especificações</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Especificação</th>
<th scope="col">Estado</th>
<th scope="col">Comentários</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('File API', '#file-attrs', 'lastModified')}}</td>
<td>{{Spec2('File API')}}</td>
<td>Definição inicial.</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilidade">Compatibilidade</h2>
<p>{{Compat("api.File.lastModified")}}</p>
<h2 id="Ver_também">Ver também</h2>
<ul>
<li>{{domxref("File")}}</li>
</ul>
|
