diff options
Diffstat (limited to 'files/pt-pt/web/api/file/lastmodified/index.html')
-rw-r--r-- | files/pt-pt/web/api/file/lastmodified/index.html | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/files/pt-pt/web/api/file/lastmodified/index.html b/files/pt-pt/web/api/file/lastmodified/index.html new file mode 100644 index 0000000000..9b05f6f3cf --- /dev/null +++ b/files/pt-pt/web/api/file/lastmodified/index.html @@ -0,0 +1,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> |