v.timestamp(1)

📦
version 8.4.2 · 8 versions
, in fedora 44

💖 v.timestamp(1) 💖

GRASS GIS User's Manual — yes bestie, we're in the manual, and today's main character is v.timestamp. 🎀

✨ NAME ✨

v.timestamp — modifies a timestamp for a vector map.

Like, print / add / remove a timestamp for a vector map. That's the whole vibe. 🦋

🌸 KEYWORDS 🌸

vector, metadata, timestamp, time

👑 SYNOPSIS 👑

v.timestamp
v.timestamp --help
v.timestamp map=name  [layer=string]   [date=timestamp]   [--help]
[--verbose]  [--quiet]  [--ui]

🎀 Flags 🎀

  • --help — prints the usage summary, iykyk. 🫶
  • --verbose — verbose module output, so it tells you everything. 💬
  • --quiet — quiet module output. shhh. 🤫
  • --ui — force launches the GUI dialog, for when you want the pretty buttons. ✨

🍓 Parameters 🍓

  • map=name [required] — the name of the vector map. Or a data source for direct OGR access, if that's your thing. 📍
  • layer=string — layer number or name. Vector features can have category values in different layers, and this number decides which layer to use. When you're doing direct OGR access, this is the layer name instead. Default: 1
  • date=timestamp — a datetime, datetime1/datetime2, or 'none' to remove it. Format: '15 jan 1994' (absolute) or '2 years' (relative). ⏰

💅 DESCRIPTION 💅

Okay so this command has 2 modes of operation, and you gotta know which one you're in:

  • If you don't hand it a date argument, it just prints the current timestamp for the vector map. reading, not writing. 👀
  • If you do specify a date argument, then it sets the timestamp for the vector map to the date(s) you gave it.

See the examples below, bestie, they make it click. Also go peek at the TIMESTAMP FORMAT description for the details. 📖

🌈 NOTES 🌈

  • Strings containing spaces should be quoted. no cap, just quote them. 🔤
  • For specifying a range of time, the two timestamps should be separated by a forward slash (/). 🗓️
  • Wanna remove the timestamp from a vector map? Use date=none. gone. deleted. periodt. 💀

🔥 EXAMPLES 🔥

Prints the timestamp for the "lidar" vector map. If there's no timestamp for "lidar", nothing gets printed (silence, iconic). If there is a timestamp, you get one or two time strings printed, depending on whether the timestamp for the map is a single date or two dates (i.e. start and end dates).

v.timestamp map=lidar

Sets the timestamp for "lidar" to the single date "15 sep 1987".

v.timestamp map=lidar date='15 sep 1987'

Sets the timestamp for "lidar" to have the start date "15 sep 1987" and the end date "20 feb 1988".

v.timestamp map=lidar date='15 sep 1987/20 feb 1988'

Removes the timestamp for the "lidar" vector map.

v.timestamp map=lidar date=none

😭 KNOWN ISSUES 😭

Spaces in the timestamp value are required. yes, literally required. not optional. don't come for me. 🙈

🦋 SEE ALSO 🦋

v.info, r.timestamp, r3.timestamp

🧚 AUTHOR 🧚

Michael Shapiro, U.S.Army Construction Engineering Research Laboratory

⭐ SOURCE CODE ⭐

Available at: v.timestamp source code (history)

Accessed: Saturday Jan 17 05:41:30 2026

Main index | Vector index | Topics index | Keywords index | Graphical index | Full index

© 2003-2025 GRASS Development Team, GRASS GIS 8.4.2 Reference Manual

and that's the whole page, bestie!! this was GRASS 8.4.2, footer date Saturday Jan 17 05:41:30 2026, © 2003-2025 GRASS Development Team, straight out of the GRASS GIS 8.4.2 Reference Manual. go timestamp something. slay 💖✨👑

📦 where this page comes from