<div class="intro">
<p>This example shows how to get and set subcookies as well as using conversion functions when retrieving subcookie values.</p>
</div>
<div class="example yui3-skin-sam">
{{>cookie-subcookie-example-source}}
</div>
<h2>Description</h2>
<p>The first three lines attempt to read the values stored in subcookies of the "example" cookie:</p>
```
var name = Y.Cookie.getSub("example", "name");
var today = Y.Cookie.getSub("example", "today", function (value) {
return new Date(value);
});
var count = Y.Cookie.getSub("example", "count", Number);
```
<p>The "name" subcookie stores a string so it is retrieved without specifying a third argument.</p>
<p>The "today" subcookie stores a date string, which should be converted to a <code>Date</code> object upon retrieval; the third argument of <code>getSub()</code> is specified as a custom function that will convert the returned value into a <code>Date</code> object.</p>
<p>The "count" subcookie contains a number and is converted to an actual JavaScript number by passing in the native <code>Number</code> function.</p>
<p>If any of these subcookies don't exist, <code>getSub()</code> returns <code>null</code>. This should be the case the first time you run the example.</p>
<p>The retrieved values are shown in the browser console.</p>
<p>After that, new values are assigned to the various subcookies:</p>
```
Y.Cookie.setSub("example", "name", "Yahoo!");
Y.Cookie.setSub("example", "today", (new Date()).toString());
```
<p>The "name" subcookie is set to "Yahoo!", the "today" subcookie is set to the value of a new <code>Date</code> object as a string, and the "count" subcookie is filled with a random number. The next time you run the example, the subcookies should have these values.</p>
<h2>Complete Example Source</h2>
```
{{>cookie-subcookie-example-source}}
```