https://github.com/djherbis/times

#golang file times (atime, mtime, ctime, btime)
https://github.com/djherbis/times

Last synced: 4 months ago
JSON representation

#golang file times (atime, mtime, ctime, btime)

• Host: GitHub
• URL: https://github.com/djherbis/times
• Owner: djherbis
• License: mit
• Created: 2015-08-29T07:08:15.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2023-10-20T15:09:49.000Z (over 1 year ago)
• Last Synced: 2024-10-28T08:14:53.509Z (4 months ago)
• Language: Go
• Size: 106 KB
• Stars: 251
• Watchers: 7
• Forks: 30
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
times 

==========

[![GoDoc](https://godoc.org/github.com/djherbis/times?status.svg)](https://godoc.org/github.com/djherbis/times)

[![Release](https://img.shields.io/github/release/djherbis/times.svg)](https://github.com/djherbis/times/releases/latest)

[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE.txt)

[![go test](https://github.com/djherbis/times/actions/workflows/go-test.yml/badge.svg)](https://github.com/djherbis/times/actions/workflows/go-test.yml)

[![Coverage Status](https://coveralls.io/repos/djherbis/times/badge.svg?branch=master)](https://coveralls.io/r/djherbis/times?branch=master)

[![Go Report Card](https://goreportcard.com/badge/github.com/djherbis/times)](https://goreportcard.com/report/github.com/djherbis/times)

[![Sourcegraph](https://sourcegraph.com/github.com/djherbis/times/-/badge.svg)](https://sourcegraph.com/github.com/djherbis/times?badge)

Usage

------------

File Times for #golang

Go has a hidden time functions for most platforms, this repo makes them accessible.

```go

package main

import (

  "log"

  "github.com/djherbis/times"

)

func main() {

  t, err := times.Stat("myfile")

  if err != nil {

    log.Fatal(err.Error())

  }

  log.Println(t.AccessTime())

  log.Println(t.ModTime())

  if t.HasChangeTime() {

    log.Println(t.ChangeTime())

  }

  if t.HasBirthTime() {

    log.Println(t.BirthTime())

  }

}

```

Supported Times

------------

|  | windows | linux | solaris | dragonfly | nacl | freebsd | darwin | netbsd | openbsd | plan9 | js | aix |

|:-----:|:-------:|:-----:|:-------:|:---------:|:------:|:-------:|:----:|:------:|:-------:|:-----:|:-----:|:-----:|

| atime | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |

| mtime | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |

| ctime | ✓* | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |  | ✓ | ✓ |

| btime | ✓ | ✓* |  |  |  | ✓ |  ✓| ✓ |  |  |

* Linux btime requires kernel 4.11 and filesystem support, so HasBirthTime = false.

Use Timespec.HasBirthTime() to check if file has birth time.

Get(FileInfo) never returns btime.

* Windows XP does not have ChangeTime so HasChangeTime = false, 

however Vista onward does have ChangeTime so Timespec.HasChangeTime() will 

only return false on those platforms when the syscall used to obtain them fails.

* Also note, Get(FileInfo) will now only return values available in FileInfo.Sys(), this means Stat() is required to get ChangeTime on Windows

Installation

------------

```sh

go get -u github.com/djherbis/times

```