This page has no translation to 中文 yet. The original English version is below. If you’d like to help, great! See how to translate a documentation page in the contribution guide.
Note This is a web-version of a tutorial chapter embedded right into the XOD IDE. To get a better learning experience we recommend to install the desktop IDE or start the browser-based IDE, and you’ll see the same tutorial there.

Custom Types

Screenshot of 013-custom-types

In addition to the primitive data types, XOD has more complicated custom types. Custom types can consist of other types or wrap C++ classes.

Consider custom type values like black boxes that can’t do anything on their own. An author of the custom type always puts some nodes which operate on such custom type values. Use these to perform actions on custom type value, query the custom type data, or create and update the custom type values.

Datetime #

On this patch, you see the datetime node, which takes few numbers and outputs a value of a custom type xod/datetime/datetime.

This type contains a so-called POSIX timestamp inside. The xod/datetime library provides nodes to manipulate the datetime and format it to in arbitrary way.

  • The datetime node is one of the type constructors. Note that the minimum value is 1st January of the 1970 year. It’s a starting point of the Unix epoch.
  • The add-seconds node shifts the date by adding some number of seconds.
  • The format-timestamp node outputs the datetime in the default format.

Bind the current time and start the simulation.

^ Add/Subtract hours

Excercise #

Format the same datetime as “24.03.2019 9:47 am”.

  1. Replace format-timestamp with the unpack-datetime node.
  2. Place an am-pm node and link it with the HOUR output.
  3. Place if-else node, link it with AM output and bind strings: “am” for T and “pm” for F.
  4. Construct a new datetime format using concat nodes as it is inside the format-timestamp node, including the “am”/“pm” suffix feature.

Run the simulation and check it out.

Add or subtract some hours using the tweak-number node that is already on the patch, to ensure that “am” and “pm” suffix works.


You’ll discover that XOD uses custom types extensivelly. They encapsulate different hardware devices, interfaces, protocols, and so on.

If you want to learn how to implement your custom type, read the guide: “Defining Custom Types”.

Found a typo or mistake? Want to improve the text? Edit this page on GitHub and open a pull request. If you have a complex proposal or you want to discuss the content, feel free to start a new thread on XOD forum.